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With VNC SDK you can connect VNC Viewers with VNC Servers 
easily over the Internet. Using VNC Cloud, no complicated 
network configuration at either end is required! 


What will you create with VNC SDK? ° 
Check it out here: https://developer.realvnc.com/ 


REAL 


Getting connected: www.realvnc.com/products/vnc/raspberrypi/ 
For more information contact vncdeveloper@realvnc.com 
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WELCOME TO 
THE OFFICIAL 
PI MAGAZINE! 


hen the Raspberry Pi Zero launched towards RASPBERRY PI MAGAZINE 
the end of last year, it turned the world of tiny The aS 
computers on its head. Cheap enough to be ; \ 


given away on the cover of this very magazine, yet more 
powerful than the original Raspberry Pi, the Zero took 
off quicker than Tim Peake’s rocket. While we’ve all 
been busy making consoles out of games controllers and : 
robots out of matchboxes (seriously!), there’s always a 

been one type of project that’s been sorely unavailable SUBSCRIBE & : : 
— anything using the Raspberry Pi Camera Module. ' — aasBocnay 
Amazingly, that’s no longer an issue: the Pi Zero 1.3 is SEE PAGE 34 FOR DETAILS ; 
here and it comes complete with a specially designed 
camera connector that works with both the old and new 
Camera Modules. Learn more about it on pages 6 and 7, 


or better yet, subscribe to the magazine for six or 12 THIS MONTH: 
t to you completely FREE (see 


months to get one sen 
6 PI ZERO 1.3 IS HERE — SAY CHEESE! 


pages 34 and 35 for details). 
There's a new Pi Zero and it comes with a camera connector 


pe manor? 


Of course, you can’t get very far with your Raspberry 
Pi projects without being able to control the General 
Purpose Input/Output (GPIO) pins. If you’d like to get 18 ELECTRONICS FOR BEGINNERS 
SS Se Make use of those devilishly useful GPIO pins with our help 
than this month’s cover feature starting on page 18. 


Electronics with the Raspberry Pi couldn’t be easier! 36 AMAZING PROJECTS SHOWCASED 


Another four incredible Pi-powered creations under the spotlight 


Russell Barnes 
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Learn how to put together this incredible Oracle-powered kit 
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PI ZERO 
VISION 


The Pi Zero is back in production and now comes with a camera connector 


To celebrate the launch of the new Pi Zero on 

16 May, Dave Akerman launched one of them 

- with Camera Module attached - in a high- 
altitude balloon. As it soared from a Herefordshire 
field to the edge of space at an altitude of over 
34km, some spectacular shots were captured 
(magpi.cc/1XeuQCo). 


Through “dumb luck”, it was discovered that 

the same fine-pitch FPC connector used on the 
Compute Module IO Board just fits onto the right- 
hand edge of the Pi Zero board. Instead of using 
the Compute Module's optional PCB adapter to 
connect to a Camera Module, however, a flexible 
custom cable has been designed. As well as being 


sleeker and more practical for miniature projects, 
it’s less costly at £4/$5. Like the new Zero itself, the 
cable is available now from the usual Pi retailers. 
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or anyone trying to get 

their hands on a Raspberry 

Pi Zero, there’s doubly 
good news. Not only is the smallest 
Pi model back in stock, due toa 
new production run of 250,000 
units, but it comes with an extra 
feature: a new port to connect the 
Raspberry Pi Camera Module. This 
opens up a whole range of new 
possibilities for miniature projects 
using a camera. 

To fit the diminutive form factor 
of the Zero, the camera port is 
slightly smaller than the CSI one 
on other Raspberry Pi models. 
Therefore, a special adapter cable 
is required to connect it to the 
wider connector on the standard 
Raspberry Pi Camera Module 
(including the NoIR). The new 
custom cable is flexible, 15cm 
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(6 inches) long, and costs £4/S5 — 
the same price as the Zero itself. 
While stressing that this is a 
revised version of the Pi Zero and 
not a brand new model, since 

the rest of the board is unchanged, 
Raspberry Pi founder Eben Upton 
pleased that a recent hiatus in 
the production for the miniature 
model, during the run-up to the 
Pi 3 launch in February, enabled 
the team to add the new camera 
connector. Asked whether this 
was something they wanted to 
include originally, Eben admits: 
“No... It?s a thing we didn’t think 
we could add.” More recently, 
however, following feedback from 
users requesting the feature, they 
realised they could fit a small 
camera connector to the right- 
hand edge of the board. 


~ 
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The rest of the board is 
unchanged, so has the same 
specs as the original Zero 


Meeting demand 

Eben tells us that they were taken 
aback by the huge demand for the 
Pi Zero, following its launch last 
November. “It’s one of the things 
with Raspberry Pi: on some level, 
we’re always surprised.” He tells us 
that they take a cautious approach 
to production numbers: “I have 


You can connect upa 
standard Camera Module (or 
NoIR) and it'll work as normal 


Extra caution was required in 
the case of the Pi Zero, since its 
production is handled in-house, 
unlike other Raspberry Pi models 
whose manufacture is licensed to 
distributors RS Components and 
CPC/Farnell. While Eben insists that 
this licensing model “is and always 
will be the heart of the business”, 


They were taken aback by the 
huge demand for the Pi Zero 


this nightmare that the one time I 
actually build a load, speculatively, 
Pll find that it’s the one product 
that people don’t like.” He reveals 
that the original Model A didn’t 

sell that well, since most users 
preferred the Model B, which had 
more features and was only slightly 
more expensive. Eben says if they’d 
ramped up production for the 
Model A at the time, “That really 
would have sunk us. So I think it’s 
always better to be cautious.” 
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the Zero is not a natural fit for it due 
to not being a high-margin product. 
Now knowing that the Pi Zero is 
in such great demand has enabled 
Eben to confidently order an initial 
production run of 250,000. “We’re 
launching with 30-40,000 units... 
We’re going to push the rest of that 
stock through quite quickly.” He 
reckons an annual production figure 
of “about a million” is achievable, 
which means that there should now 
be enough Zeros to meet demand. 


Anew flexible adapter cable 
has been created to link the 
Zero to the Camera Module 


The new camera 
connector is smaller 
than the CSI port 

on other Pi models 


Eben has been delighted by the wide range of 
projects created so far using the Pi Zero. “It’s been 
weird seeing how prevalent it’s been,” considering 
that the Zero represents only a small fraction of 
total Pi sales. “The small form factor [and self- 
contained nature] obviously enables a Lot of stuff... 
build it into a mouse, build it into a joystick/ 
game controller.” With the camera connector now 
offering even more possibilities, we can't wait 

to see what users create with the new Zero. 
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UPDATED 


The latest version of Raspbian has some great additions, such 
as improved Bluetooth support and an internal backup tool 


aspbian, the official 

Raspberry Pi operating 

system, is always in 
development. There’s always 
something new coming, witha 
desired features list a mile long 
that Raspbian crafter Simon Long 
works with to try to improve your 
Raspberry Pi experience. Recently, 
a big update to the operating 
system was released with a number 
of additions and changes that 
crossed off some of these features, 
while addressing support for 
recent hardware updates. 


Improving Bluetooth 
While support was added for 
the Bluetooth and Wireless LAN 
chip of the Raspberry Pi 3 during 


its initial release, the Bluetooth 
support was a little barebones. 

It was easy to upgrade using 
something like Blueman to adda 
graphical interface, though. In this 
release, Simon has added a custom 
Bluetooth interface. 

“Td hoped to be able to use one 
of the existing Linux Bluetooth 
Uls,” Simon explains in the release 
blog. “{After] trying them all, none 
were really what I was looking 
for in terms of usability and 
integration with the look and feel 
of the desktop. I really didn’t want 
to write one from scratch, but that 
was eventually what I did.” 

The interface is quite 
straightforward: by clicking on 
the Bluetooth icon in the taskbar, 


you can make the Raspberry Pi 
discoverable to other Bluetooth 
devices or add a Bluetooth device. 
The ‘Add New Device’ window 
will fill up with local Bluetooth 
devices which you can then pair 
with. Right now, there’s only full 
support for keyboards, mice, and 
audio devices. Bluetooth audio now 
works slightly better than before, 
due to the inclusion of PulseAudio 
tools. If you recall from a tutorial 
back in issue 44, you needed to 
install the latter to get the audio 
output working. 


SD card backup 


A common question in the Pi 
community is how to back up the 
SD card. There are several existing 
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Geany also works with Python and may be preferable to IDLE for some people 


methods, although none of them 
are native to Raspbian. A new tool 
has now been added that allows 
you to copy the SD card while the 
Raspberry Pi is running. 

The SD Card Copier requires 
you to have a USB card reader 

for it to work. It’s fairly simple: 
you just need to plug an SD card 
into the reader, plug the reader 
into the Raspberry Pi, and tell the 
SD Card Copier to copy the data 
to that card. 

“The program doesn’t restrict 
you to only copying to acard the 
same size as the source,” Simon 
mentions. “You can copy toa 
larger card if you’re running out of 
space on your existing one, or even 
to a smaller card (as long as it has 
enough space to store all your 
files - the program will warn you 
if there isn’t enough space).” 


Programming tools 

The new version of Raspbian also 
comes with a new GPIO library, 
pigpio, which provides two benefits. 
First, it unifies access to the GPIO 
pins from Python, C, and other 
languages. Secondly, as a result 

of this, you won’t need to sudo 
programs that use the GPIO pins. 
This includes Scratch. 
The popular text editor/light 
DE Geany has also been added to 
Raspbian. It allows for programming 
in multiple languages; if you’re more 
of a seasoned coder, you might get 

n better with this than some of the 
ther tools included in Raspbian. 
There’s your usual series of minor 
pplication updates and UI tweaks, 

s well. It’s a great update and you 
can read up on the full rundown 

of changes on the release blog: 
magpi.cc/1Va2aei 
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There are two main ways you can get the new update. The quickest 
way, if you're already running a copy of Raspbian Jessie, is to open the 
terminal and use the following commands: 


sudo apt-get update 
sudo apt-get dist-upgrade 


sudo apt-get install piclone geany usb-modeswitch pi-bluetooth 
sudo apt-get install python-pigpio python3-pigpio 


You can also reinstall Raspbian to the card. If you have the time 


and can easily transfer anything you're working on with it, then we 


recommend doing this. Find instructions here: magpi.cc/1MYYTMo 
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Transfer files to USB 

Avery quick and simple way to perform a backup 
is literally just to make a copy of any important 
files to a USB stick plugged into the Pi. This won't 
remember any settings or extra software you have 
installed, though. 


Transfer files to computer 

Similar to USB; turn off your Raspberry Pi and 

plug your SD card into another computer. From 
there, you can copy the files onto the other system 
without much trouble, as well as more easily being 
able to copy any settings or profile files. 


Card copy 

In the same way you can write an image to an 

SD card, you can do the reverse and copy an SD 
card to create an image. This is similar to the SD 
Card Copier utility. However, you can save it to 
anywhere on your computer, which likely has more 
space than a USB stick. 
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FLOODING 


Cornish students watch rising sea levels sink their school 


using a Raspberry Pi supercomputer 


ornish students spent 

the day modelling climate 

change on a Raspberry Pi 
supercomputer at their annual 


The University of Exeter event 
enabled students to learn Big 
Geo Data processing methods. 
Students used Grappolo, a cluster 
computer built by Spatial Ecology 
(spatial-ecology.net) to model 
rising sea levels. 

“This passionate community 
of young future scientists met 
researchers and took part 
in a range of activities and 
workshops,” says Dr Andrew 
Cowley, computing development 
officer at the University of Exeter. 
“The aim was to identify the 
single greatest challenge the 
local environment faces.” 


Multiple Raspberry Pis are linked 
together to create a cluster. It runs 
the same software as a true high- 
performance supercomputer 


Students used Grappolo (magpi.cc/1TUNHxi), 

a supercomputer cluster made from three 
Raspberry Pi 2s. Grappolo is used to teach cluster 
computing using a grid engine. The micro cluster 
computer replicates the functioning of the 
biggest cluster computer facility in South West 
England. Grappolo is similar to a Raspberry Pi 
cluster developed at Southampton University, but 
aimed towards teaching big data processing for 
geographic information systems methods (rather 
than raw computation). It costs around £140 to 
build and is a portable and perfect replica of 

an operating system running on an actual high- 
performance cluster computer. 
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Environment & Sustainability Day. 


Andrew ran the Flooding Risk 
Workshop along with Dr Stefano 
Casalegno, associate research 
fellow at the University of Exeter. 

“We investigated probability 
and risk,” says Andrew, “and 
modelled impacts of sea level rise 
under climate change scenarios 
using the open-source software 
QGIS (a geographic information 
system). Students used Grappolo 
and QGIS software to model 
how much sea levels would 
have to rise before their school 
becomes submerged.” 

The Raspberry Pi cluster 
“simulates the functions of the 
biggest cluster computer facility 
in the South West,” says Andrew. 

“Grappolo is similar to another 
Raspberry Pi cluster developed 
at Southampton University, but 
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Cornish students modelled the impact of sea 
level rise under climate change scenarios 


is aimed towards teaching and 
demonstrating ‘big geo data’ 
processing methods rather than 
raw computation. 

“Within the workshops, 
students visualised impacts 
of global sea-level rise using a 
1km resolution digital elevation 
model (DEM) derived from 
the NASA’s Shuttle Radar 
Topography Mission (SRTM).” 

SRTM data was captured 
by the Space Shuttle Endeavour 
in 2000, and released globally 
in 2014. The radar data was used 
to create the first near-global 
set of land elevations and is now 
available from the US Geological 
Survey website (magpi.cc/1TEyE]j). 

“The public availability of 
enhanced global SRTM topographic 
data will greatly benefit 
international efforts to understand 
better natural processes that shape 
our planet, prepare for and respond 
to natural hazards, and anticipate 
and prepare for the impacts of 
global change,” commented 
NASA chief scientist Ellen Stofan. 
“NASA is proud to have played a 
critical role in creating these data 
that will benefit society through 
open data sharing.” 

Using a small, Raspberry Pi- 
powered supercomputer to crunch 
NASA data sounds cool, but it was 
locally sourced data that captured 
the students’ imagination. “What 
pupils enjoyed most,” says 
Andrew, “was the use of a local 
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digital elevation model (DEM) 
from the Tellus project 
[www.tellusgb.ac.uk]. 

Tellus South West is a project 
funded by the Natural Environment 
Research Council (NERC). They 
used an airborne lidar survey to 
create maps and data. According 
to Tellus: “The maps and data 
produced show the soils, rocks, 
landscape, and ecology of Devon 
and Cornwall in unprecedented 
depth and detail, and augment 
existing data to provide the 
two counties with among the 
best and most comprehensive 
environmental datasets anywhere 
in the world.” 

This incredibly accurate data 
of the surrounding area enabled 
students from Cornwall to simulate 
sea-level rise in Cornwall, to flood 
their schools and other places 
familiar to them. 

“The most rewarding part of 
the day for Stefano and for me 
was showing the students about 
the Raspberry Pi, Linux, and FOSS 
doing great things together,” 
Andrew tells us. “It was also 
great that so many of them asked 
further questions about the Pi, 
the Grappolo, high-performance 
computing, and also environmental 
issues facing Cornwall.” 

Students elected the Flooding 
Risk workshops, run by Andrew 
and Stefano, as the winner of the 
Environment & Sustainability 
Day event. 


» 


Students used two sets of data in the Flooding 
Risk workshop. 

The first is data collected from NASA's Shuttle 
Radar Topography Mission (magpi.cc/1Yqd3aL). 
SRTM flew aboard the Space Shuttle Endeavour 
in February 2000, mapping Earth's topography 
between 56 degrees south and 60 degrees north 
of the equator. During the 11-day mission, SRTM 
used an imaging radar to map the surface of Earth 


numerous times from different perspectives. 
Local data of Cornwall from the Tellus Project 

(tellusgb.ac.uk) was also used. This local 

geophysical survey measured traces of natural 


magnetism and radioactivity to make maps of the 
properties of the rocks, soils, and fluids under the 


skin of the Earth. 


The Grappolo is a small Raspberry Pi supercomputer used 
to teach cluster computing using a grid engine 
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The Astro Pi units 
have been gathering 
data aboard the ISS 
and have returned 
their sensor readings 
to Earth 


nor 
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VU ULNVIONNIE 


RESULIS ARE IN! 


Get your hands on the sensor data collected from the Astro Pis on 
the ISS and apply for a special schools conference with Principia 
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ata from the two Astro Pi 

units, orbiting the Earth 

aboard the ISS 
Space Station), is now publicly 
available. These special Raspberry 
Pis, nicknamed Ed and Izzy, blasted 
into space along with UK astronaut 
Tim Peake in December 2015. 

Part of their payload contained 
seven winning programs, created 
by school-age students. After 
these student experiments had 
completed, the Astro Pis set about 
a long-term ISS environmental 
monitoring program. 


International 


This mission has produced 
data files chock-full of ISS sensor 
readings. These files have now 
been made available to the public, 
allowing budding scientists to 
analyse the data collected. 

Ed and Izzy have returned the 
captured data to Earth, in the 
form of CSV (comma-separated 
value) files. The data is ready for 
download and analysis by the 
Raspberry Pi community. 

The sensor readings can 
be downloaded directly from 
the Raspberry Pi website; 


the data is included in the 


Flight Data Learning 


(magpi.cc/1ZNxUVE). 


Resource 
This 


resource walks students through 


the sensor readings a 
them understand the 

Jamie Bailey, CEO a 
of Initial State, has al 
the Astro Pi data and 


ISS, uploaded it to Ini 


nd helps 
data. 

nd founder 
ready taken 
placed it 


into a web visualisation. “We took 
the CSV data collected from the 


tial State’s 


tools, and shared each dataset 
publicly for anyone to use,” says 


James. “You can also bring data 
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into Initial State’s data analytics 


tools through file uploads. The data 


delivered from the ISS is in CSV, 
a supported file format.” 

You can view the Astro Pi 
data visualisation in your 


ASTRO PI RESULTS ARE IN! 
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Raspberry Pis that have been 
collecting sensor measurements 
aboard the ISS. 

Dave Honess, the education 
resource engineer in charge 
of the Astro Pi project, will 


Ed and Izzy have returned 


the captured 


data to Earth, 


in the form of CSV files 


browser on the Initial State blog 
(magpi.cc/1ZNyoMY). 


Holding an Astro Pi 

To celebrate Tim Peake’s return 
from his mission aboard the ISS, 
the UK Space Agency is inviting 
young adults to attend two special 


Principia School Conference events 


in November (magpi.cc/25b6eRD 
and magpi.cc/25b63WE). 
Attendees will also be able to view 
some flight-equivalent Astro Pi 
units. These are the same devices 
as Ed and Izzy, the augmented 
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be at both conferences with a 
selection of the incredibly rare 
Raspberry Pi devices. Only eight 
flight-equivalent Astro Pis were 
ever made, constructed from 
aerospace-grade aluminium, and 
two of these went on to become Ed 
and Izzy aboard the ISS. “They’re 
kind of like holy artefacts to 
Raspberry Pi fans,” says Dave. 
Students presenting at the 
Principia School Conference will 
be able to use the flight-equivalent 
Astro Pi devices as part of 
their presentation. 
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ASTRO PI DATA DOWNLOAD 


Data from Ed and Izzy, the Astro Pi units aboard the 
ISS, can now be downloaded in the standard CSV 
(comma-separated value) format. Three separate 
files are available. 

The first two sensor readings were collected in 
the Columbus Module, and the third in the Node 2/ 
Unity module. 

Location on ISS 


Unit Length 


Astro Pi Vis (Ed) Columbus 2 weeks 


Astro Pi Vis (Ed) Columbus 4 weeks 


Astro PiIR (Izzy) Node 2 2 weeks 
You can download the data directly from the 
Astro Pi Flight Data Analysis worksheet on the 
Raspberry Pi website (magpi.cc/1ZNxUVE). 

This sheet also explains how to understand 

and use the data. 

You can work directly with the data, using Python 
or a program like Mathematica or MATLAB (both of 
which are free on the Raspberry Pi). 

If you don't want to produce your own graphs, 
then James Bailey from Initial State has already 
created some visualisations that you can view 
online. See Jamie's blog at Initial State for more 
information (magpi.cc/1ZNyoMY). 
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Tim's mission aboard the ISS has 
been extended by two weeks, giving 
him more time with Ed and Izzy 


Tim has inspired UK schoolchildren 
with his mission aboard the ISS 
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“This conference isn’t just for 
the winners of the various Principia 
competitions: it’s for anyone 
who’s been affected by Tim’s 
mission. I bet there are some really 
interesting stories out there,” says 
Dave. “It’s going to be brilliant!” 

The Principia Schools Conference 
gives students the chance to 
demonstrate a science project to 
a panel of space experts, possibly 
including Tim himself. 


Welcome home, Tim 
Tim has received a two-week 
extension to his stay aboard the 
ISS. The ESA (European Space 
Agency) has decided to keep the 
ISS operating at full capacity with 
six astronauts. 

He is now due to land in 
the steppe of Kazakhstan 
on 18 June with two fellow 
astronauts. Tim will return to the 
European Astronaut Centre in 
Cologne, Germany, for check-ups 
and research into how humans 
adapt to living in space. 

His schedule when he returns to 
Earth will be extremely busy, but 
Tim hopes to be at the Principia 
School events and wants to 
meet people at the conferences. 
Everybody is working hard 
to achieve this goal. 

Tim has mixed thoughts about 
returning: “Although I am looking 
forward to being back on Earth and 
seeing friends and family again, 
each day spent living in space is a 
huge privilege and there is much 
work to do on the Station. 

“This extension will keep 

the Station at a full crew of 

six for several days longer, 
enabling us to accomplish more 
scientific research. 

“And, of course, I get to enjoy 
the beautiful view of planet Earth 
for a little while longer!” 

Each crew member flies as a 
trio to the ISS and back in a Soyuz 
spacecraft. About every three 
months, a crew returns to Earth 
shortly before a new one arrives, 
often leaving a few days when 
only three astronauts look after 
the Station. 
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Izzy, our Astro Pi unit with an IR sensor, 
is attached to a window of the ISS 


Joining the Conference 
The Principia School Conference 
events will take place in November 
2016, at universities in York and 
Portsmouth. Attendance at each 
event is free, and the UK Space 
Agency will offer travel bursaries 
to help with the cost of attending. 
Places are limited and potential 
attendees will need to submit an 
application. “The judging panel 
would love to see reports of things 
such as scientific experiments, art 
projects, whole school projects, 
special events, and community 
outreach,” explains the Principia 


A 


AstroPi 


It would be great to see a 
strong Astro Pi contingent at 
both conferences, so we strongly 
encourage anyone who engaged 
with Astro Pi to apply. The deadline 
for applications is Thursday 
15 September 2016 at 12 noon. 
See the box on the right for details 
on how to get started. 
Applications to the conferences 
are not limited to previous 
winners of Principia or Astro Pi 
competitions, so anybody can 
enter. The UK Space Agency 
wants your entry to tell the story 
of your project, describe what 


It would be great to see a 
strong Astro Pi contingent 


website. “The applications should 
communicate what work has 

been done, what was learnt by 
doing the work, and why this 
should be shared with an audience 
at the conferences.” 

The Principia mission has a 
tremendous range of educational 
activities linked to it, one of which 
is the Astro Pi. The conferences 
will be attended by students from 
across all of the Principia missions. 

There are up to 500 places 
available at both of the conferences; 
the teams and individuals who 
present the strongest applications 
will be invited to take part. 
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you’ve learned, and what long- 
term effects the work has had 
on your school. 

To illustrate the kind of 
applications Principia is hoping 
to see, it’s worth mentioning the 
Astro Pi testimonial that maths 
teacher Gillian Greig, from The 
Priory School in Hitchin, wrote last 
year (magpi.cc/1ZNxNcT). Gillian’s 
testimonial is a great example of 
the kind of story the organisers 
will enjoy seeing. 

The best applications will 
become presentations, viewed 
by a team of space experts — 
hopefully including Tim Peake. 


SS) t 
Oe 


Individuals and groups of young people (of school 
age) can apply to the Principia Schools Conference 
events. There is no limit on the size of the group that 
can apply, but a maximum of six children along with 
two adults will be invited to attend. 


University of Portsmouth = Wed 2 Nov 2016 


University of York Sat 5 Nov 2016 

Overseas applications are welcomed, though the 
judges will be giving first priority to applications 
from the United Kingdom, Channel Islands, and the 
Isle of Man. International applications of high calibre 
may be successful. 

The deadline for applications to both events 
is Thursday 15 September 2016 at 12 noon. 

To learn more about the Principia School 


Conference and how to apply, visit: 
magpi.cc/1ZNy9A2 
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ps | Use the GPIO pins, some electronic components, : a ! 


and code to do cool stuff with the Raspberry Pi A 
fe very mont i the Mage, a wis ue we're ects to - 
we have projects filling explain to you exactly how the 
the pages that hook up electronic components work and Oo 
directly to Raspberry Pi using the how you wire them up, along -_— 
> | GPIO pins running down the side with a bit of a briefing on how to 


of the board. They’ re pretty easy program them with GPIO Zero, 


to use and, with some patience, before showing you some excellent 

you can figure out roughly how examples of the kind of things you 
o————0 they work by reading all the can do with Pi electronics when 
different tutorials. you know how. | 


With the creation of the GPIO 
Zero Python library, it’s never been 


° easier to start coding electronics. All the code m 
With this in mind, we decided to this tutorial is 
-——s remove the step between idea and 
O project by starting you off witha -O 
9 proper guide to getting electronics -o 


working with your Raspberry Pi. 
—= -O 
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Fig 1 Switch circuit 
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RASPBERRY PI 


Reading circuit diagrams and wiring them up to your Raspberry Pi 


he Raspberry Pi is great 
for learning computing. 
Whether that’s coding 
or more advanced uses of a 
computer, the Raspberry Pi has 
lots of tools to aid you in learning 
about them. It’s also very good 


a 


at physical computing, which in 
this context means programming 
and interacting with the real 
world through electronics. In 
simple terms, physical computing 


COMMON COMPONENT SYMBOLS 


>RESISTOR 
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>BUTTON/SWITCH 


with the Pi is something like 
programming it to turn on an LED, 
an electronic component in an 
electronic circuit. 

The electronic circuits are 
the physical part of a physical 
computing project connected to 
the Raspberry Pi. These circuits can 
be simple or very complex, and are 
made up of electronic components 
such as LEDs, buzzers, buttons, 
resistors, capacitors, and even 
integrated circuit (IC) chips. 

At its simplest, an electronic 
circuit lets you route electricity to 
certain components in a specific 
order, from the positive end of a 
circuit to the negative (or ground) 
end. Think of a light in your house: 
the electricity passes through 
it, so it lights up. You can adda 
switch that breaks the circuit so it 


—o~o— 


only lights up when you press the 
switch. That is an electronic circuit. 


Reading circuit diagrams 
Building a circuit can be easy if 

you know what you’re doing, but if 
you’re making a new circuit or are 
new to electronics in general, you’ ll 
most likely have to refer to a circuit 
diagram. This is a common way 
you’ll see a circuit represented, and 
these diagrams are much easier to 
read and understand than a photo 
of a circuit. However, components 
are represented with symbols which 
you’ll need to learn or look up. 

Fig 1 is an example of the light 
circuit we talked about before. Here 
we have a power source (a battery in 
this circuit), a switch, a resistor, and 
an LED. The lines represent how 
the circuits are connected together, 


>CAPACITOR 


ao 
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What GPIO Zero is and how you can use it to 


program electronics connected to your Raspberry Pi 


Se nce the components are 
Sieeras @) all hooked up to your 

Zz Raspberry Pi, you need 
to be able to control them. The 
Raspberry Pi is set up to allow you 
to program it with the Python 
language. This has also been made 
simpler recently with the addition 
of GPIO Zero. 

GPIO Zero was created to 
simplify the process of physical 
computing, helping new coders to 
learn. It’s a Python library which 
builds upon the existing GPIO 
libraries RPi.GPIO, RPIO, and 
pigpio. However, while those 
libraries provide an interface to the 
GPIO pins themselves, GPIO Zero 
sits above them and provides a way 
to interface to the devices that you 
connect to those pins. 

This change simplifies thinking 
about physical computing. 
Consider wiring a simple push 
button to GPIO 4 and ground pins. 
In order to react to this button, 
we need to know that the pin 
should be configured with a pull 
up resistor, and that the pin state 
when the button is pushed will be 
0. Here’s what this would look like 
in the classic RPi.GPIO library: 


from RPi import GPIO 


GPIO. setmode(GPIO.BCM) 
GPIO. setwarnings (False) 
GPIO.setup(4, GPIO.IN, 


GPIO.PUD_UP) 
while GPIO.input(4): 
pass 


print("Button pushed!") 


To complete beginners, there’s 
quite a lot going on there, which 
gets in the way of actually 
experimenting with it and even 
teaching the simple logic required. 
Here’s the equivalent code in 
GPIO Zero: 


from gpiozero import 
Button 


btn = Button(4) 

while not btn.is_pressed: 
pass 

print("Button pushed!") 


The boilerplate, stuff you 
have to blindly enter without 
understanding why you’re 
entering it, is reduced to the barest 
minimum that we can manage. 
The name ‘GPIO Zero’ derives from 


GPIO ZERO 


read all the docs here: 


magpi.cc/10d1xtB 


GPIO NUMBERS 
40-pin GPIO header key for 
Raspberry Pi 3, 2, B+, and A+ 


3.3V 
GPIO2 
GPIO3 
GPIO4 
GNV 
GP1017 
GP1IO27 
GPIO22 


GP1014 
GP1I015 
GP1IO018 
GND 
GP1023 
GPIO24 
GND 
GPIO25 
GPIO8 
GPIO7 
DNC 
GND 
GPI012 
GND 
GPIO16 
GPIO20 
GP1021 


3.3V 
GPIO10 
GPIOg 
GPIO11 
GND 
DNC 
GPIO5 
GPIO6 
GP1013 
GPl1ig 
GPI26 
GND 


GPIO Zero uses the BCM GPIO numbering rather 
than the pin number - use this handy table to 
remember which is which 
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Connected to GPIO 4 
(pin 7), we've set this to 
be a GPIO Zero object 
called btn in the code. 
It is pulled up to ground 
using a resistor 


The LED is known as 
led in the code and is 
connected to GPIO 17 
(pin 11). The resistor 
makes sure the current 
going through the LED is 
right and goes to ground 


The Raspberry Pi 
interprets the signals as 
described by the code 

- in this case it creates 
awhile loop, a piece of 
code that repeats itself, 
which checks for button 
presses to turn the LED 
on and off 


Install the latest version of 


RASPBIAN 


to get full access to GPIO Zero! 
raspberrypi.org/downloads 


“<a% 
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this ‘zero boilerplate’ philosophy, 
which was first espoused by Daniel 
Pope’s Pygame Zero library. 

The logic is also straightforward, 
with no curious inversion of the 
input value. 


Ways to turn on an LED 
GPIO Zero also tries to provide 
several means of attacking 
problems, as some coders may 
find particular methods easier to 
get their head around. Here, we’ve 
extended our script to control an 
LED attached to GPIO 17 with our 


button. Instead of looping to wait 
for the button, we use some of the 
available wait_for methods: 


from gpiozero import 


Button, LED 
btn = Button(4) 
led = LED(17) 


while True: 
btn.wait_for_press() 
led.on() 
btn.wait_for_release() 
led.off() 


You can test this code with the 
circuit we created on the previous 
page. This method works fine for 
one button, but starts to get tricky 
when we want to use two. Say 
we’ve got buttons wired to GPIO 
pins 3 and 4, and we want the LED 
to light when either is pushed. This 
is quite hard with the wait methods 
above, so it makes sense to switch 
to ‘event-driven’ programming: 


from gpiozero import 
Button, LED 
from signal import pause 


btni1 = Button(3) 

btn2 = Button(4) 

led = LED(17) 

btni.when_pressed = led.on 

btni.when_released = led. 
of F 

btn2.when_pressed = led.on 

btn2.when_released = led. 
of F 

pause() 


Simple! But there’s a subtle bug. 
Hold down one button, then press 
and release the other; the LED goes 
off despite the fact a button is still 
being held; think about how the 
events are being fired to see why! 

Fortunately, GPIO Zero provides 
another programming style which 
solves this by allowing us to tie the 
state of the LED to the states of 
the buttons: 


from gpiozero import 
Button, LED 

from gpiozero.tools import 
any_values 


WHAT'S NEW IN GPIO ZERO? 
GPIO Zero can use buttons, 
LEDs, buzzers, and lots of other 
components. The library is 

ever expanding. 


>SERIAL PERIPHERAL 
INTERFACE 
Released in 1.2.0, there is now an 
SPI implementation for specific 
compatible devices to talk to the 
Pi. This allows for analogue inputs, 
analogue-to-digital converters, 
and other pretty advanced stuff, 
but it makes using them much 
more simple. 


>HOLD EVENTS 

These are variables in something 
like button code that allow you to 
set a length of time a button should 
be pressed before being recognised 
as a press. This can be useful if your 
button is very twitchy in a project 


you're using. 


>SOURCE TOOLS 

The tools library for the source and 
values properties enables you to 
tweak and play with the way GPIO 
Zero handles specific components 
and functions. We won't be covering 
them this issue, but they're important 
for advanced uses. 


from signal import pause 
btni = Button(3) 
btn2 = Button(4) 


led = LED(17) 

led.source = any_ 
values(btni.values, btn2. 
values) 

pause() 


This uses the new tools module 
from GPIO Zero 1.2, which is 
designed to work with the source 
and values properties used above. 
Basically, GPIO Zero is excellent 
for getting started with physical 
computing, yet is complex enough 
that you can do more advanced 
things with it than just wait for a 
button press. 
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9 The PIR sensor detects 
motion via changes 
ou in the levels of 
N | infrared radiation 


> 1x HC-SR501 
PIR sensor 
magpi.cc/ 
arwsEL7 


> 1x Mini piezo 
buzzer 
magpi.cc/ 
arwsXG2 


> Jumper wires 
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Stop people from sneaking up on your stuff by 
creating a motion-sensing alarm that buzzes 


when it detects someone 


> 
+O 
= 


eed to protect your room 
or precious items from 
ne’er-do-wells or nosy 
family members? With just a PIR 
motion sensor and a buzzer wired 
up to your Raspberry Pi, it’s very 
simple to create an intruder alert. 
Whenever movement is detected 
in the area, a loud beeping noise 
will raise the alarm. To take things 
further, you could add a flashing 
LED, an external speaker to play 

a message, or even a hidden 
Camera Module to record footage 
of intruders. 


The mini piezo buzzer 
beeps an audible alarm 
when motion is detected 


While the PIR is powered 
by 5V, its output is 3.3V so 


no resistor is required 


>STEP-01 

Attach PIR motion sensor 
First, we need to wire the PIR 
(passive infrared) sensor to the 
Pi. While it could be hooked to 
the GPIO pins directly using 
female-to-female jumper wires, 
we’re doing it via a breadboard. 
The sensor has three pins: VCC 
(voltage supply), OUT (output), 
and GND (ground). Use female- 
to-male jumpers to connect VCC 
to the ‘+’ rail of the breadboard, 
and GND to the ‘-’ rail. Wire 
OUT to a numbered row, then use 
another jumper to connect that 
row to GPIO pin 4. 


>STEP-02 

Wire up the buzzer 

Next, we’ll hook up the mini 
buzzer. Place its two legs 


To take things further, you could 
add a flashing LED or an external 
speaker to play a message 


across the central groove in the 
breadboard. Note that the longer 
leg is the positive pin; wire its 
numbered row to GPIO pin 3 on 
the Pi to connect it. Wire the row 
of the buzzer’s shorter leg to the 
‘—? rail, then connect the latter 
to a GND pin on the Pi. Finally, 
connect the ‘+’ rail to the Pi’s 5V 
pin to power the PIR sensor. 
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PTfalarm.py 


: DOWNLOAD: 
gpiozero magpi.cc/1Ynsdop 
MotionSensor, Buzzer 
time 


pir = MotionSensor(4) 
bz = Buzzer(3) 


( ) 


pir.wait_for_no_motion() 


True: 
( ) 
pir.wait_for_motion() 
) 
bz.beep(0.5, @ 
time.sleep(3) 


feature 


he Raspberry Pi 3 is about 

ten times as powerful 

as the original model of 
Raspberry Pi - and for people who 
have been using the Pi for the past 
four years, you really notice the 
difference. Even the jump to Pi2 
was quite big! While the original Pi 
would regularly max out the CPU, 
the newer Pis don’t do this as much. 
We can still track this CPU usage, 
though, and with a special LED that 
changes colours, we can create a 
light that tracks how much of the Pi 
we're using. 


You can use any 


size breadboard for 
this circuit 


The resistors limit the 
current flowing through the 
LED and prevent damage 
to the Raspberry Pi 
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Common cathode 
RGB LED. The 
longest leg is the 
cathode - connect 
it to ground 
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rgb_cpumon.py 


RGBL 
time 


myle 


gpiozero 
ED 
psutil, colorsys, 


d = RGBLED(14,18,15) 


DOWNLOAD: 


magpi.cc/1sy4eC2 


cpu = psutil.cpu_percent() 


r = cpu 
g = (10¢ 
b = @ 
myled.color (r,g,b) 
time.sleep(@.1) 


cpu) 1¢ 


ROB ZWETSLOOT 


lot of people roll their eyes 

and complain about vanity 

when it comes to the art 
of the selfie, but we all know it’s 
nothing like that. New outfit? New 
glasses? Eyeliner wings symmetrical 
today? Why not chronicle it? It’s a 
great confidence boost. Taking what 
we’ve done so far with GPIO Zero, 
we’re going to make use of a button 
with a Pi Camera and construct our 


own custom, Pi-powered selfie stick. 


STEP-O1 


One thing we didn’t cover in the 
intro to electronics was how to 
install the Raspberry Pi Camera 
Module onto the Pi. Make sure yours 
is off and then find the camera 
connector; it’s the white rectangle 
between the HDMI and audio ports 
on the Pi 2 and 3. Lift it up gently 
and then place the Pi Camera ribbon 
cable in the slot with the silver 
connector facing the HDMI port. 
Push the slider back down. 


STEP-02 


To get the camera working on the 
Raspberry Pi and in Python, we 
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TTT 


Most selfie sticks 
use Bluetooth- 
connected buttons; 
ours is wired for no 
loss of signal 


You'll need a battery 
pack to make the most 
out of this project 
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We've used a 
full-size Raspberry 
Pi here, but you 
could always use 
the new Pi Zero 
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selfie.py 


; DOWNLOAD: 
gpilozero magpi.cc/Selfie- 
Button Camera 
datetime 
datetime 
picamera 
time 


btn = Button(14) 
pc = picamera.PiCamera() 


def picture(): 
timestamp = datetime.now() 
pc.capture( str( 
timestamp) ) 
time.sleep(1) 
True: 
btn.wait_for_press 
picture() 


MIKE COOK 


You can use any model 
of Raspberry Pi with 
many of these projects 


Ultrasonic distance 


sensor - gives out a is S 
pulse prapartional he HC-SRo4 ultrasonic 
You can use any to any reflecting distance sensor isa great 
seven-segment object in front of it ; ‘ t 
display, but favourite with Pi robot 
alternatives : 
might have a makers. It works by bouncing 
cifferenk pinout ultrasonic sound off an object and 


timing how long it takes for the 
echo to return. This time is then 
converted into a distance which 
can be displayed on a single-digit, 
seven-segment display. Here you 
can acquire the skills to handle 
inputs and outputs. You also get 
to use seven-segment displays, 
which are quite cool in a retro kind 
of way. 


STEP-01 


The seven-segment display is 

a collection of LEDs, with one 

LED corresponding to one of the 
segments. All the anodes (positive 
ends) are connected together. This 
should be connected to the 3V3 
supply. The cathodes (negative 
ends) should be connected to a 
resistor to limit the LED current, 
and the other end of the resistor 
to a GPIO pin. To turn the LED on, 
all you have to do is set the GPIO 
output to be LOW (oV) and it will 
complete the circuit for the current 
to flow. 
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display Distance.py 


ITHEAD STUDIO displays the distance DOWNLOAD: 
in decimetres on 7 


segment display 


Raspberry Pi B revi 


magpi.cc/1NqJjmV 


6 |Rs |Rq [Rs [Re [Ro 
2202] 2209|2202| 2209] 2202 


m0 gpiozero LED 
rs gpiozero DistanceSensor 
. time 


F 
Raspberry 
PiBrev2 


seg = [LED(27, 


False),LED(25, 

False), LED(24, False), 
LED(23, 

False), LED(22, 

False), LED(18, False), 
LED(17, -alse)] 


segmentPattern hh a2 34) 51] sis 24 os 
1,6,4,3],[9, 925556 ],[1,2,5,6],[0,2,3,5, 


ils @to5 
[0,2,3,¢ ) ere 


Dy ty ly Fy 5 Tikes 25 2 ],[@,1,2,4,5 


, #6 to A 
[2,3,4, ,6],[0,3,4,5],[1 
,6],[9,4,! 36] ] B to F 


32,3,4,6], [( 33545 
sensor = DistanceSensor(15,4) 


def main() : 
( 


distance sensor.distance 
distance in decimeters 
( , distance) 
distance Q: 
distance ] 
display(int(distance) ) 
time.sleep(@.8) 


def display( Ne 
a range(@,7): 
seg[i].off() 
number < 1¢€ 
z range(@, len( 
segmentPattern[number]) ): 
seg[segmentPattern[ 
number ][i]].on() 


Main program logic: 
__name__ 
main() 


ROB ZWETSLOOT 


N 
an \ 
= his one is a bit cool. The between five different stations using STEP-0O1 
original code for this was variable resistors/potentiometers. 


developed by The MagPi 
boss Russell Barnes long before 
GPIO Zero was a thing. The code was 
over 100 lines long and allowed you 
to change the volume and select 


Now, with the latest version of GPIO 
Zero, we’ve got it down to 21 lines, 
although that does leave out volume 
control for the moment. We’ll show 
you how we did it. 


Before we do anything with the 
code, we need to make sure we 
can actually play the radio station. 
We'll be using the online M3U 
streams to do so, which can be 


found for many digital or online 


' : radio stations. Unfortunately, the 
TETTT Tit iit 


OSI(DISF 


: . The Raspberry Pi can't 
> : < ™..,J handle analogue inputs 
7 , : on its own, so we need this 
MCP3008 chip to do it Like the tuner of 
radios of old, we can 
use this to change 
stations by twisting 


a 
> (wWaWY> 


The MCP3008 is 
hooked up to very 
specific pins on 


the Pi - they exist 
on original models 
as well 
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: internetradio py 


MCP3008 


100kQ Raspberry Pit 


iozero 
es ae A DOWNLOAD: 
ti magpi.cc/10G2Y9i 
ime 
os 


station_dial = MCP3008(0@) 
Magic 


DGND Radiol 


def change _station( is 


os.system( ) 
os.system( 
station ) 


station_dial.value 
station = Magic 
change_station(station) 
station_dial.value 
station = Radiol 
change_station(station) 
time.sleep(2@.1) 
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A Camera Module is used 
to record the fish swimming 
around inside the tank 


The LCD displays an 
animated blend of desktop 
and recored fish footage 


» The Fish-eye 
was an art 
installation 
in Oregon 


» The tank was 
made from 
acrylic and 
acrylic glue 


» Five common 
goldfish lived 
in the tank 


» The tank cost 
around $50 
(£35) to build 


» It took 12 hours 
for the fish tank 
glue to hold 
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There’s something fishy about Thomas Hudson’s new monitor. 
We investigate the display that’s also an aquarium 


e adore this hybridised 

fish-tank and LCD screen. 

Known as the ‘Fish-eye’, 
the project was build by Thomas 
Hudson, a developer at the Oregon 
Museum of Science & Technology. 

The Fish-eye is a fascinating 

creature. Unexpectedly, the LCD 
monitor is situated at the front 
of the tank, and the Raspberry Pi 
software superimposes the fish 
onto the display. “A Raspberry 
Pi Camera Module sits on top of 
the fish tank, looking down,” 
explains Thomas. 


Fish have a tranquil, calming 
effect, and watching them glide 
serenely around a tank while 
you work is awesome. And if you 
want to watch space fish, then 
the Earth or Moon make great 
fishy backdrops. 

“T built the tank out of acrylic 
using acrylic glue,” Thomas tells 
us. “It is amazing stuff: fairly 
toxic, but it welds the acrylic 
together so it is watertight. 

“The monitors were free,” 
he adds. “One from a free box on 
the sidewalk and another froma 


friend. Everyone is getting rid of 
19-inch monitors right now.” 

With the custom tank 
constructed, Thomas stripped 
down the LCD screen and fixed it 
to the front of the fish tank. 

“The camera captures live video 
of the fish from the top view and 
streams it live to the LCD on the 
front of the tank. So when you’re 
looking at the front of the tank, 
you are looking at both live video 
of the fish from the top view while 
watching the ‘real’ fish as seen 
through the LCD screen.” 
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You don't actually see the fish. 
The camera records them and 
superimposes them on your desktop 


This intersection of moving life 
and still pixels gave the project 
its artistic message 


The Fish-eye uses quite a bit of 
bit of software to achieve its unique 
effect. It runs a picture program 
called Feh (feh.finalrewind.org) 
to flash full-screen images of 
space fish on the Moon. Oxmplayer 
elinux.org/Omxplayer) is used 
to show the live stream and 
also recorded video of the fish. 
inally, the Raspberry Pirunsa 
surveillance script based on Motion 
MMAL (magpi.cc/23MBxfH) to 
identify moving fish and attach 
bubbles to those fish displayed 
on the live video feed. 
“T worked on the project for 
about a month,” reveals Thomas. 
“Two shows were happening, 
so I made two Fish-eyes. One 
[was] for an annual electronics art 
exhibition called ByteMe! 5.0; the 
second was for the Portland Winter 
Light Festival.” 

This intersection of moving 
life and still pixels gave the 


TH 
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project its artistic message. 

“Tt was important for something 
to [be] living in the box,” 
explains Thomas. “This is 
juxtaposed against how much 
time we spend staring at a ‘box’ 
that is not living, and is very 
much dead, with the exception 
of all those electrons buzzing 
through them and the cold 
emitting light.” 

The Fish-eye was retired 
after the Portland Winter Light 
Festival was over, and the goldfish 
returned to a regular tank. “It was 
a sculptural piece,” says Thomas. 
“T feel that kids got it right away. 
They loved the idea of ‘fish on the 
Moon’ and ‘fish in space’. 

“T think there is something very 
beautiful about having depth to 
your monitor. You can still focus 
on your work, as the screen is 
crystal clear.” Indeed, we think 
the Fish-eye is a fabulous display. 
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This part of the build is as it looks: le 
the chimney stack allows for air , ea 
flow throughout the device 


mexico 


The box looks very classic, but it 
belies a fairly high-tech interior 
for roasting coffee beans 


United States 


BO COSMAS TER WALL MAP SERIES 


A fun little addition allows 
for a flame effect to show 
when the roaster is on 


Pa COFFEE ROASTER 


in a cafetiere, 
also known as 


ees Want to up your coffee-making game even further? Make a cheap yet 
peerallecat accurate coffee roaster, like Mark Sanders did, for a better cup 


Ethiopian, 
and Mexican 
beans have 
roasted well 


= aking a truly good cup 
U1 of coffee takes a lot of 
effort. Essential oils 
evaporate from ground coffee 
within minutes, so pre-ground 
coffee is out. Boiling water will 
burn the coffee as it’s brewed, 
so you need it at about 80-85°C. 
Grind size, exact weights, precise 
timing, brewing method: all of it 
is important when making coffee. 
Possibly the most extreme step 
you can take is to roast your own 
beans to make sure they’re fresh 
and to your own requirements, 
and this is what Mark Sanders has 
found himself doing. 
i : “While in search of quality 
i __! coffee, | stumbled upon a webpage 


» This is Mark's 
first Raspberry 
Pi project 


» The whole 
thing took 
between two 
and three 
months to build 


» The roaster 
is controlled 
by acustom 
web interface 


5 


= 
> 
< 

’ 
* 
< 

te 


The build 

effects on the 
case add an extra 
level of class 

to this custom 
coffee roaster 
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RASPBERRY PI COFFEE ROASTER 


GETTING THE PERFECT ROAST 


>STEP-01 


that suggested home roasting as a 
source of tasty coffee,” Mark tells 
us. “Getting started is as simple 
as purchasing a used popcorn 
popper from the local thrift store 
for $4-S8.” 

Popcorn poppers are popular 
among home-roasters, as they 
stir the beans while very hot air 
blows on them —- very similar 


y 


>STEP-02 >STEP-03 


from the popper and used them 
in another vessel. 

“T took the heater and fan 
from a popper and added several 
other components to create a 
temperature-controlled coffee 
roaster,” Mark explains. “A 
thermocouple was added to 
measure the temperature inside 
the roasting chamber. A GPIO pin 


I took the heater and fan from 
a popper and added several 
other components 


to commercial coffee roasters. 
There was a small problem, 
though, according to Mark: 

“Tt roasted the coffee too fast, 
as I frequently finished roasts 
in under five minutes [when 
they should take 7-12]. In order 
to slow the roast down, I would 
unplug the popper for 30-second 
intervals. This grew tiresome and 
I started to ponder how I could add 
temperature control to the popper. 
This was the beginning of my 
Raspberry Pi project.” 

The solution is familiar to those 
who have tried (or at least seen) 
sous vide projects: controlling 
the heating apparatus. In this 
case, Mark cannibalised the parts 


was connected to an AC relay that 
allowed the Raspberry Pi to control 
the popper’s heater. I developed 
a web interface to set the 
temperature and save roast data 
for archiving. The web interface 
shows the current temperature 
using an analogue dial gauge, as 
well as a chart that graphs the 
temperature for the entire roast. 
For some extra flair, four LEDs 
were added to the front of the 
roaster to simulate a flame when 
the heater is turned on.” 

A full list of parts and 
instructions to build a roaster 
yourself is available online: 
magpi.cc/228QtW9. The build is 
quite fiddly, with a lot of soldering 


and patience required, according 
to Mark. However, the results 
speak for themselves: 

“(The roaster] has completed 
over 20 roasts and it has worked 
very well. I’m able to control the 
temperature throughout the entire 
roast process, log notes about the 
roast, and save the roast data for 
reference later. It’s much better 
than unplugging and plugging in 
the popper by hand.” 


raspberrypi.org/magpi 


Projects 


Above The 
coffee roaster 
is controlled 
by a number 
of electronic 
components to 
get it working 
just right 
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BOT 


A robot that plays Connect 4 against a human 
opponent thanks to a bit of maths and code 


» The robot took 
two months to 
complete 


» Games at the 
Pi Birthday 
Bash were 


This is the robot's arm, which 
dispenses yellow pieces in 
an attempt to defeat humans 


Helpful instructions 
let you know when 
you can start and 
how to do so 


Plastic counters 

are recognised by 
colour and dropped 
into the game board 


limited to ten 
moves each 


» Only a few 
people won 
the game in 
ten moves 


» The add-on 
board that 
works the 
servos will soon 
be available 
as a HAT 


» David is 
currently 
converting an 
Ohbot to run on 
Raspberry Pi 
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ou may have seen 
computers that can 
defeat grandmasters at 
chess, win at trivia game shows 
or, more recently, beat a human 
at Go, but have you ever played 
Connect 4 against a robot? Humour 
us by answering no (statistically 
speaking, you probably haven’ t) 
and then prepare to be amazed 
at the 4bot created David Pride. 
The 4bot has humble beginnings, 
as David explains its origins to us: 
“My wife bought me the brilliant 


MeArm kit and I used it to build 
a Lego block sorter, as you do. 
This used the Pi Camera Module 
and a colour recognition script 

I wrote in Python to identify 
the different coloured blocks, 
and then used the arm to drop 
them in the correct ‘buckets’.” 
A video of this can be seen here: 
youtu.be/FJ8WV1iuLhFA. 
“Based on this, I was then 
looking for other uses for the 
colour-capture code,” David 
continues. “Connect 4 seemed 


like a really good choice. Research 
soon led me to find that the game, 
and the logic behind it, is far from 
simple. There is good information 
online; however, whilst I found 
many versions of Connect 4 
for Python, few of them ran 
successfully on the Pi.” 
The robot works by taking 
a picture of the game board, 
processing the colours, and then 
giving the game program the 
state of the board to calculate 
the next move. 
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The 4bot was a smash at the 
Raspberry Pi fourth birthday 


party, with over 100 games played w > 
“= 


“Tn terms of how well it plays, 
Connect 4 is a ‘perfect’ game in 


mathematical terms,” David reveals. 


“There are a huge but finite number 
of solutions, and they can all be 
calculated with enough processing 
power. The trade-off is in the depth 
of search and therefore the time 
taken to calculate each move... If 
you increase the search depth, this 
massively increases the calculation 


Recognising the colours currently 
in play is not easy, though, and took 
a bit of trial and error to get right. 

“The trickiest part was 
undoubtedly capturing the game 
board accurately every time,” David 
tells us. “It is extremely light- 
dependent, as the Python module 
works by capturing the RGB value 
of the 42 spaces on the board. 
These values, however, do change 


In terms of how well it plays, 
Connect 4 1s a ‘perfect’ game 
in mathematical terms 


time. So I selected a middle ground 
where the bot plays a pretty mean 
game, but the total time per move is 
still acceptable. With capturing and 
processing the image, calculating 
the next move, and delivering the 
counter, the total time per turn is 
around 25 seconds.” 


hee 


The Pi Factory Lego block sorter 
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dramatically depending on the 
lighting. I wrote a ‘testcard’ script 
that can be run with counters in 
known locations. This script then 
reports back what it thinks it sees, 
and the tolerances for the RGB 
components can then be adjusted 
until the result matches what is 
actually there on the real game 
board. This made the game more 
portable, as it can be adjusted to its 
surroundings each time.” 

Current upgrades for the robot 
involve a stronger frame, as it 
came in for heavy use at the fourth 
Pi birthday party. Maybe it’s time 
to bring robot Connect 4 battles to 
the next Pi Wars?... 


| Dapress 


er 
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The interface designed by Alain displays six cartoons. 
Scott uses the buttons to choose which video to play 


SCOTT 


One MagPi reader has built a customised television 
that his autistic son can use unaided 


» The build took 
two weeks to 
complete 


» Arch Linux is 
used for the 
interface 


The answer was to make Scott’s 
bedroom “Scottcompatible! You can 
lock everything from the wardrobe 
to the window, and we’ve installed it. So we tried another one witha 
a camera in the wardrobe too.” Plexiglass sheet in front of it, but 
But this isn’t much fun for Scott. he tried to destroy it too.” 


aving a child with autism 
isn’t easy. Alain Mauer’s 
son, Scott, can’t make eye 
contact and doesn’t talk. He also 
requires constant supervision. 
“Communication with Scott is 


“Scott had a 32-inch TV in his 
room because he loves to watch 
cartoons, but one day he destroyed 


» Videos are 
played using 
Omxplayer 


» The scripts 
were written 
using 
Python 3.5 


» Scott has 


42 


Kanner 
syndrome, 

a severe form 
of autism 


Scott 

enjoying his new 
TV. He can bash 
the buttons (and 
screen) all day 
long without 
damaging it 
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very difficult,” says Alain. “He 
understands us, but can’t tell us 
what he wants. You can’t leave 
him alone for a single second. 
“But from time to time he has 
to stay in his room,” adds Alain. 


20 0saeaaas ff 


” 


He doesn’t like staying alone in 
his room and finds it boring. “He 
doesn’t play with toys or use his 
imagination to play. But we know 


that he likes cartoons with music,” 


reveals Alain. 


Alain started to wonder if the 
problem wasn’t the television, 
but what was playing. “He has no 
ability to tell us, or to stop it, on 
his own,” explains Alain. “So he 
gets frustrated, and tapping against 
the noisy thing is his only way of 
stopping it.” 
The answer was to builda 
television that was Scott-proof, 
and the result is Scott TV: an 
unbreakable television with the 
screen hidden inside. Six large, 
easily bashable buttons start and 
stop cartoons playing. A Raspberry 


Pi - tucked safely inside the wooden 


case — powers the whole project. 
Built out of 18mm multiplex 
wood, the Scott TV case houses 
the television, but it still needs 
protection. A sheet of 8mm 
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SCOTT TV 


Projects 


The Raspberry Pi displays 
a menu with six cartoon 
options. When a button is 
pushed, the corresponding 
movie starts to play 


CREATING 
SCOTT TV 


The television screen is housed 
inside a sturdy wooden frame 
and set back from the front. A 
sheet of Plexiglass protects it 
from being bashed 


Six piezo sensors sit next to 
the screen. On the other side 
are large, handmade buttons 
that Scott can bash without 
damaging the television 


Plexiglass in front of the display is 
the solution. “It wasn’t complicated 
to build,” says Alain. “With a 
jigsaw, a drill machine, and a little 
table saw, all is possible. 

“The Raspberry Pi is the main 
part of the project. Normally, I tell 
everybody that the Pi is optimised 


any button when a movie is playing, 
it returns to the menu screen. 

“T used NOOBS to install Arch 
Linux. For [a] console-based media 
player, I used Omxplayer. | then used 
Python 3.5 to write the scripts. ?'m 
not a Linux expert or a programmer, 
so Google was my friend. The 


>STEP-02 


To see him so happy was the 
biggest thank you from him to me 


for controlling stuff and not as a 
media player. But I was wrong: it 
plays full HD videos.” 

The Scott TV has six large 
buttons, handbuilt by Alain with 
piezo switches on the inside. “The 
buttons were the challenge,” says 


scripts are available on GitHub 
(magpi.cc/22amFIG). 

“Since it was set up in his 
room, Scott likes to stay longer 
and push the buttons,” Alain 
tells us. “Sometimes he sits in 
front of the media player and just 


>STEP-03 


Alain, “but you can use any kind 

of buttons.” 

The menu displays previews 

from six cartoons (one next to each 
button). If Scott pushes a button, the 
cartoon starts playing. If he pushes 
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looks at the animated menu, 


lau 


he plays the Twinkle Twinkle 


ittle Star video ten times and 


ghs. To see him so happy was 


the biggest thank you from him 


to 


»” 


me 
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ESSENTIALS 
LEARN | CODE | MAKE 


AVAILABLE NOW: | 


> CONQUER THE COMMAND LINE 


The 


> EXPERIMENT WITH SENSE HAT 
> MAKE GAMES WITH PYTHON 
> CODE MUSIC WITH SONIC PI 


i From the makers of the 
official Raspberry Pi magazine 
Ma 


OUT NOW IN PRINT 
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Sense HAT 
magpi.cc/ 
1TGGUt5 


Dynamic DNS 
service 
magpi.cc/ 


1TSwg3g 


Matplotlib 
magpi.cc/ 
aTSwgAt 


Running web 
server 
magpi.cc/ 
aTSwis8 


Virtual host 
magpi.cc/ 
aTSwiYU 
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Date 


Data taken from the Sense HAT 
can be easily analysed, once 
plotted out like this 


Taking advantage of Matplotlib’s 
powers, the date is shown 
in a correct format 


MAKE A SENSE HAT 
TEMPERATURE 


RECORDE 


WITH 
PYTHON 


Data obtained from the Sense HAT can be plotted directly with Matplotlib. 
With a running web server, this data can be tracked from anywhere! 


he Sense HAT enables us to measure different 
parameters of our environment. However, 
the raw data obtained from the sensors can be 
unmanageable. Plotting the data can help us analyse 
it much more easily; with Python and the powerful 
Matplotlib library, we can both obtain data from the 
sensors and create a wide variety of graphs to turn 
boring numbers into intuitive results. We can also 
enable a web server and create a virtual host to host 
the plots so we can access them over the network, 
creating a beautiful dashboard. While there are 
services which already provide this, we can build our 
own for free. 
Sense HAT is probably one of the bests HATs you 
can get for the Raspberry Pi, with plenty of sensors to 
play with. There are some services that let you take 
advantage of these sensors and create interactive 
dashboards, allowing you to see plots of the data from 
the sensors with just a network connection. However, 
these services are usually too limited unless you pay 
for a subscription. 


Matplotlib lets you create graphs from Sense HAT data, 
making it the perfect partner for the HAT. It can make a 
lot of different graphs, but in this tutorial only the basic 
one-line plot is going to be covered. 


Setting up the web server 
With a dynamic DNS (DDNS) service, a running web 
server, and a virtual host, you can create your own 
dashboard. While the virtual host, web server, and 
DDNS service are not essential, without them it would 
only be possible to track the results locally. Let’s 
suppose that while you are reading this, you have 
already set up everything you need. 
The first step is to create a folder called dashboard 
in /var/www. In this folder we will save the CSV file 
generated by the program, with all the data, and also 
the HTML or PHP files to create a beautiful dashboard. 
There are a lot of tutorials out there on how to make 
your own personalised, custom dashboard. After that’s 
done, create a folder called images in /var/www/ 
dashboard, in order to save the created graphs there. 
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Above Different plots can be made: for example, one with two 
lines that measures temperature and humidity over time 


Importing required libraries 
In the Python code, we need to import different 
libraries: csv in order to write data to a file, datetime 
in order to get the date, and matplot1lib to create the 
plots. After importing these, we first need to be sure 
that the program can run without an X server running; 
that’s why the matplotlib.use("Agg") function is 
used. Now we also need to import matplotlib.dates 
to format the date for the plot, matplotlib.pyplot 
to draw the plot, SenseHat to get data from the Sense 
HAT, and finally time, since we’re going to execute all 
the code inside a while loop, with a value for time. 
sleep of 3600 seconds. 

Matplotlib needs a list of two values to plot them, 
that’s why we create x and y empty lists. Now we 
can start taking temperature data from the Sense 
HAT, and also the date that corresponds to the value 
of the temperature. 

Once the data is taken, a CSV file is opened in 
append mode to add the data. This way, we can 
also have the raw data and not only the plot. 


Creating the graph 

Instead of taking the data from the CSV file, Matplotlib 
directly plots the lists that were previously created. To 
add data to the list, we just append the read temperature 
and date values to them. With the data on the lists, we 
can plot the graph and afterwards format both axes and 
write the proper labels. The final plot-clearing section in 
the code is required: if not included, the new plot would 
be drawn over the old one and make a mess. 

The code is only an example, but can be used as the 
basis for amazing programs. As mentioned, Matplotlib 
is so powerful that we can create other kinds of plots 
as histograms or animated plots. While the Sense 
HAT is used for this tutorial, any other sensors can be 
used. Also, data could be directly taken from raw data 
files rather than sensors. All this will be covered at the 
author’s GitHub repo (magpi.cc/1W1QZ35) soon. 

Matplotlib was created by John D Hunter. He passed 
away in 2012, and this tutorial and all the programs 
made with his amazing library should be considered 
in memory of him. 
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MAKE ATEMPERATURE RECORDER ‘Tutorial 


DashboardPipy 


#!/usr/bin/env python 


DOWNLOAD: 
#-*-coding:utf-8-*- magpi.cc/1W1QZ35 


# Create graphs with temperature and data. 


# Created by Iker Garcia. 


import csv 

import datetime 

import matplotlib 

matplotlib.use("Agg") # Added to plot graphs without running X server. 
import matplotlib.dates as md 

import matplotlib.pyplot as plt 

from sense_hat import SenseHat 


import time 


bad 
" 


[] # Define list needed for the plot. 


[] 


Ne 
u 


while True: 
try: 

sense = SenseHat() 
temp = sense.get_temperature() # Reads temperature from Sense HAT. 
temp = round(temp, 2) 
now = datetime.datetime.now() 
file = open("/var/www/dashboard/temperature.csv", "a") 
# Opens file to save data. 
writer = csv.writer(file, delimiter = ",") 
data = [now,temp] 
writer.writerow(data) # Writes data on the csv file. 
X.append(now) # Updates list for the plot. 
y.append(temp) 


plt.plot(x,y) # Plots data set. 
plt.gca().xaxis.set_major_formatter( 
md.DateFormatter("%Y-%m-%d %H:%M:%S")) # Format the date. 
plt.gca().get_yaxis().get_major_formatter().set_useOffset(False) 
# Format y axis, in order not to get scientific units. 
plt.xlabel("Date") # x axis label. 
plt.ylabel(u"Temperature (\u@@B@C)") # y axis label. 
plt.gcf().autofmt_xdate() # Correct date format on the axis. 
plt.savefig( 
"/var/www/dashboard/images/1.png", bbox_inches = "tight") 
# Save the plot with the optimal size. 
plt.cl#() # Clears the plot, in order to get a tidy plot. 
time.sleep(3600) # Code is executed each hour. 


except KeyboardInterrupt: 


break 
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Tutorial 


Recreate arcade classic 
Asteroids, or as we like to 
call it,: 4573R01D5 


The rocks in the game now have 
collision detection, meaning 
there's now real danger 


JON SILVERA 


CEO and founder of FUZE 
Technologies, Jon Silvera is keen 
to help kids learn how to code. 
fuze.co.uk 


With this final step, you can 
actually play the game as it 
was intended 


PRESS ENTER TO 


MAKE AN 
IN FUZE BASIC 


Finish making an incredible Asteroids clone in FUZE BASIC 


> Raspberry Pi 
with updated 


Raspbian 


> FUZE BASIC 
magpi.cc/ 
1SbgYsY 


> Sound files 


> Last month's 
code 
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with part two of our tutorial 


ast issue, our ‘4573RO1D5’ game started to 
take shape with movement, firing and, of 
course, our menacing rocks floating around. 
With that, the basic mechanics of the game are there, 
but there’s no gameplay to speak of yet. This final 
tutorial adds collision, spaceships, scoring, sound, 
hyperspace, an attract screen, and the obligatory high 
score table. 
You'll need FUZE BASIC. Visit: 
www.fuze.co.uk/getfuzebasic/ to get the 
latest version. 


Continue? 

To start, grab the files needed: magpi.cc/1WBCdIG. 
Start up FUZE BASIC and load 4573R01D5 into 
the editor. To do this, after starting FB you’1l be 


presented with Direct mode, so press F8 to load a file 
or F2 to go to the editor and then load a file. Youll 
then see the full program listing. There’s a lot of 
code that’s in the final version; we’ll go through how 
it all works in this tutorial. 
The program consists of a main LOOP, then a 
whole series of PROCedures to perform all the 
main functions. 
t’?s important to note that the WAIT command sets 
a maximum delay minus the amount of time taken 
in milliseconds. Ona fast system, you should set 
this toWAIT ( @.016 - (timeTaken / 10@0@)) 
to maintain a constant 60 frames per second. On 
a Raspberry Pi 2, a delay of 0.010 is better — and 
remove it altogether if running on an original Model 
B or B+. Play around to see what you like. 
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MAKE AN ASTEROIDS CLONE IN FUZE BASIC 


Explaining the player code 

Every time the player is initially placed on the screen, 
we use DEF PROC initialisePlayer to make sure 
that there are no rocks nearby. Each asteroid has its 
distance to the player checked and if it’s too close, we 
update the asteroids and try again. Note that this is 
not UPDATEd, so isn’t seen. 

The DEF PROC newExplosion(exX, eyY) routine 
is called every time a bullet hits a rock, a rock hits 
you or an enemy, or if an enemy hits anything. A new 
explosion is created and put in motion to be drawn 
by the next routine. DEF PROC drawExplosions 
takes us through the active explosions, and each one 


This final tutorial adds collision, spaceships, 
scoring, sound, hyperspace, an attract screen, 
and the obligatory high score table 


of its variables is updated so that each bit of debris 
(a pixel!) moves in the given direction and at the 
designated speed. 

When a player loses a life, all the variables required 
to start a new life are set up once again using DEF 
PROC resetPlayer. Basically, everything is reset and 
repositioned as though the game were just beginning, 
but score, level, and other gameplay data is left alone. 

Drawing the player ship is handled by DEF PROC 
drawPlayerShip and is the simplest routine in the 
entire program. It just runs through the x and y 
coordinates held in the playerData array and plots 


We’re not allowed to hold down the fire button 
and we’re only allowed a maximum of five bullets on 
screen at once. So, if the RETURN key is pressed and 
isn’t being held down, and the number of bullets is 
less than maxPlayerBullets, then we’re good to 
go! Finally, we check to see if our ship has left the 
screen and if so, reposition it on the opposite side. 


Display the action 

In DEF PROC silvoids, a LOOP goes through each 
asteroid - @ TO maxSilvoids LOOP. We check for 
off-screen and wraparound if needed; next, we figure 
out what kind of asteroid it is (the type, size, and 


number of lines), then draw the rock. The screen itself 


is drawn with DEF PROC drawScreen, which also 


displays the score, any text, and the number of player 


ships remaining on the screen. 

The statement DistCheck = FN distance 
(silvoid (count, sX), silvoid(count, sY), 
pX, pY),inDEF PROC collision, works out the 


the line. Note that if pThrust (player thrust) is active, qa 


then a couple of extra lines are drawn to show it. 
There’s also the DEF PROC explodePlayer routine, 
which draws a few tiny lines and then expands them 
over a few frames to simulate the ship exploding. 


Coding the gameplay 

Let’s start with DEF PROC gameOver. This simple bit 
of code displays the ‘GAME OVER’ text briefly when 
you lose. DEF PROC newLevel resets the asteroids 
and positions the player in the centre of the screen, 
ready to begin a new level. DEF PROC resetSilvoids 
resets the asteroids, based on the current level plus 

a minimum of 4; it starts at 5 on level one, then 
increases by one for each level. Each asteroid is given 
a shape type, position, speed, and direction. 

For moving the ship, the code uses DEF PROC 
playerControls. Here, scanKeyboard(scankey) 
checks for multiple keys at the same time. Zand X 
rotate the ship. Next, we check for thrust (RIGHT 
SHIFT). If thrust is active, i.e. TRUE, then thrust/10 is 
added to the player’s x and y position. Finally, we add 
a decelerator using pThrustX = pThrustX * @.995, 
so the ship slows down of its own accord. 
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As well as FUZE BASIC, which brings the BASIC 
language up to date, you can also get FUZE 
hardware that's reminiscent of the BBC Micros from 
the eighties. They're also powered by Raspberry 

Pi and you can do some GPIO electronics on them 
as well. Playing this custom version of Asteroids on 
here is sure to trigger nostalgia in certain people. 
You can have a look at the available models on the 
FUZE website: fuze.co.uk/ products 


>FUZE BASIC 


DOWNLOAD: 


magpi.cc/1WBCqIG 


FUZE BASIC 


As it's based 
on the BASIC 
programming 
language, if 
you still have 


BASIC skills left 
over from the 
eighties, they'll 
still mostly 
apply today. 
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TRUE 
EXPERIENCE 


The game 
remembers 

high scores and 
displays them on 


the attract screen 


LAST OF 
ITS KIND 
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distance between each asteroid and the player ship. If 
it’s less than the radius of the ship and the rock, i.e. 
touching, then it’s a crash! When we hit a big rock, 
we want it to break into two, then again for a medium 
one; if it’s a small one, there’s just the explosion, so 
we use DEF PROC silvoidSmash to do this. 

DEF PROC newPlayerBullet scans through 
the maximum number of bullets and if it finds 
an empty slot, creates a new one. DEF PROC 
drawPlayerBullets checks to see if we need to wrap 
them around the screen, calculate their updated 
positions, and draw a little circle in place. 


Setting up the game 

All the initial setting up takes place in DEF PROC 
setup. If you want to try some early hacking, this is 
where you begin. DEF PROC hiScoreFile creates an 
initial high score list. 

DEF FN distance(fnx1, fny1, fnx2, fny2) is 
without a doubt the most important five lines of code 
in the entire program. This function works out the 
distance between two points, which we then use to 
check if any two objects collide. 

Then we have DEF PROC text(textText$, 

textX, textY, tR, tG, tB, textSize, bold) 
and DEF PROC fontData. The first routine draws 

our text to the screen, but using vector lines and not 
system fonts. We can also draw symbols, but a simple 


tiny circle is used for a full stop. The second routine, 
fontData, reads all the character data. The data is 
represented as ‘A’, the actual character, and then a 
number specifying how many coordinate points are 
required for that character. 

The score routine, DEF PROC score(points), 

is separate so that we can keep a close eye on the 
score itself. We need to add a new life for every ten 
thousand points, so we have a second scoreCheck 
to keep track. 

DEF PROC initialiseSounds could be included 
in the main setup, but it can be good to keep things 
separate where possible. It’s where we load in and 
define our sound effects and music. 


Create a demonstration 

The routine DEF PROC attractScreen uses an 

array to store numerous copies of the ‘4573R01D5’ 

logo, each with a slightly different x and y position, 

size, and colour fade. These are calculated using COS 

and SIN to create the circular and wavy effects you 

see on the title screen. A rather fine tune is played 

in the background, too. Hats off to David Silvera 

for that one! 
The attract screen also uses the DEF PROC 

colourChange procedure to select new colours 

for the logo, and a high score table is created with 

DEF PROC enterHiScore. An arcade game is never 
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RELEASE DATE: NOVEMBER 1979 


DESIGNERS: LYLE RAINS, ED LOGG, 


AND DOMINIC WALSH 


PUBLISHER: ATARI, INC 


HARDWARE: MOS TECHNOLOGY 6502, 


QUADRASCAN 


HIGH SCORE RECORD: = 41,338,740, 
JOHN MCALLISTER, 


6 APRIL 2010 


The original Asteroids is one of the first major hits 
of what is considered the golden age of arcade 
games, during the 1970s and early 1980s, when 
video games were just starting out. Games in this 


era are typified by classics such as Pong, Space 


Invaders, and even Pac-Man. Asteroids wasn't 
wholly original, though, being based on concepts 
from a few previous games such as Spacewar! and 
Computer Space. However, the final product was 
different from the handful of shoot-'em-ups that 
preceded it. 

Asteroids existed in a time when vector graphics 
and (now considered traditional) pixel-based 
raster graphics were still both used, depending on 
what type of game you were making. Vector was 
used for Asteroids to allow for greater precision 
from the shots fired by the ship, resulting in its 
iconic triangle ship and asteroids, and other minor 
graphical effects. 

Atari began to port Asteroids to its various home 
gaming console models during the Eighties, 
strengthening its legacy as one of the all-time 
greats of video games. 


complete without a high score table where you can 
add your own initials. While this is showing, the 
game plays in the background, albeit without the 
player. Use Z and X to select letters and # to confirm. 

When we start a new game from within a game, we 
only need to set a few variables rather than setting 
everything all over again. DEF PROC gameVariables 
handles that. If no enemy ship is in play, then DEF 
PROC enemyShip creates a new one, introducing it 
based on a random timer which is shortened by the 
level number. Also, bullet frequency, ship speed, and 
size of the enemy are all influenced by the level. 

The enemy bullet routine DEF PROC 
drawEnemyBullets counts through all the active 
ones in the array and if TRUE, plots a tiny circle in 
place. Finally, DEF PROC newEnemyBullet is the last 
procedure but also quite acool one. ATAN (ABS (ty3 
/ tx3)) is used to determine the angle of the player 
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* Explosive rapid-fire space action * 1 or 2 players are challenged to destroy asteroids and enemy 
spacecraft * New Atari-designed QuadraScan™ display system * New personal high score table display ¢ Optional 
“Hyperspace” * Optional coinage including Susan B. Anthony coin slot * Bonus play at 10,000 points 


ship in relation to the enemy ship. We then modify 
this with eBullet(n, eBaccuracy), calculated 
using a random angle divided by the level. We start 
with a potential angle of up to +180 degrees divided 
by the level (divided by two to be kind). By level 20, 
this comes down to a +9 degree accuracy range. The 
result is that enemy bullets become more precise 
as the levels progress. It also has the bonus effect 
of making the enemy seem intelligent, as they will 
sometimes fire just ahead of you. Very nasty! 

At around 1,100 lines, 4573R01D5 has become quite 
the chunk of code. It is, however, incredibly small, 
as the whole thing is just under 39,000 bytes, or 
38kB. It would compress down quite a lot if we took 
all the comments out, and it could be optimised 
to bring it down much further. Quite simply, 
with a bit of tweaking, it would comfortably fit 
onto a ZX Spectrum! 


ARCADE 
PERFECT 
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BRAM DRIESEN 


‘4 A Drupal developer for Capgemini, 
These wires with . . “rr s : ae he loves to ‘bake’ projects 
bullet connectors : 7 ‘ ‘ ‘ with Raspberry Pis and fly 
go to the tower light . with multicopters. 
: @BramDriesen 


Asimple circuit board = ‘ wt 
to switch 12V safely j f F — 
= ~ q 


_~ 
SS 


Power lead and micro- . 12V to USB converter to 
USB connection for the power the Raspberry Pi Zero 


CREATE 
ea JENKINS BUILD 


> 220-ohm resistors 


>12V DC 
tower light 
magpi.cc/ 
arGNbwB 


> 12V power supply 


aaa Jenkins is a great tool to monitor code quality. For greater visibility 
> 12V to USB 


converter of the build status, you can build an awesome tower light that uses it 


> Perma-Proto HAT 
magpi.cc/ 
1TQQcn8 


magine being able to show the status of 

your Jenkins projects to anyone in the same 

room without the hassle of logging in to 
the dashboard. With some LEDs, a few other cheap 
components, and some soldering skills, you can 
complete this project. You can take it to the next level, 
however, by using an industrial tower light instead 
of regular LEDs. Employing an existing API, you can 
retrieve almost any data from Jenkins and get a nice 
visual indicator of the status of your project. 


> Micro-USB to 
Ethernet adaptor 


> Miscellaneous 
other parts 


Make a HAT 

First, we need to create the HAT. We used a Perma- 
Proto board from Adafruit, but you can also use a 
breadboard if you don’t want a permanent solution. 
In this version, the following GPIO pins were used, 
since they best fit the layout: 


Using some 
neodymium 
magnets, you can 
mount the tower to 
any metal object, 
such as a closet or 
fridge door 
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CREATE A JENKINS BUILD STATUS LIGHT 


PIN 18: Red 
PIN 23: Buzzer 
PIN 24: Yellow 
PIN 27: Green 


You can use the GPIO output voltage in combination 
with a MOSFET and a resistor to switch 12V safely to 
the LEDs. There’s also a 12V to USB converter to power 
the Raspberry Pi from the barrel jack, and a small 
power switch. 


>STEP-02 

The Python Jenkins-API 

You need to start off with a clean Raspbian Jessie 
image (not the Lite version) and a Raspberry Pi Zero 
(make sure to solder the GPIO header pins!). After you 
have burned the image and completed the basic setup, 
make sure to set up an internet connection. You can 
either use a standard WiFi dongle or a micro-USB to 
Ethernet adaptor. Once you are ready, proceed with 
the installation of the Jenkins API. In the terminal 
window, enter the following command: 


sudo apt-get install python-jenkinsapi 


>STEP-03 

Create the Python script 

Most of the coding work has already been done for 

you and is available on GitHub. To get everything you 
need for this project, clone the project from GitHub on 
your Raspberry Pi by using the following command in 
your terminal: 


git clone https://github.com/BramDriesen/ 
rpi-jenkins-tower-light.git 


Make sure to clone the project in a directory where you 
can easily find it afterwards, such as the home directory. 
Youcanusecd <folder>/<name>andcd ../ 
commands to navigate through folders in your terminal. 
You can also download a ZIP file of the source code from 
the versions page: magpi.cc/1rGOjAt. 


>STEP-04 

Configure the code 

Now we have cloned the project, we’ll browse into 

the directory to configure the Python script. Copy the 
default configuration file default-config.py and rename 
it to config.py. Youcan use the command cp default- 
config.py config.py to do this all in one go. After 

you have copied the file, edit it with your favorite text 
editor; we like to use nano, so in this case we’d issue the 
command nano settings. py. Now change the default 
configuration lines so it contains your credentials, 

job name(s), and correct GPIO pins according to your 
situation. If you have only one job, make sure the jobs 
parameter remains an array with one item inside. 
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Default-config.py 


# Default configuration file for Jenkins 
# Copy this file and name it config.py 
jenkinsurl = "http://example-url.com: 8080" 
username = “your-username" 
password = "“your-password"™ 
jobs = 
gpios = { 
"red': 18, 
"buzzer': 23, 


['job-name-1', 'job-name-2'] 


"yellow': 24, 
"green’: 27, 


>STEP-05 

Auto-run on boot 

Since we’re working on a permanent solution, we 
want to ensure that our script launches immediately 
on boot. We can edit our re.local file to launch the 
script when the Raspberry Pi is booted up. Edit your 
rc.local file with sudo nano/etc/rc.local and add 
the following line to direct the script to auto-start 
upon boot: 


python /path/to/the/script/rpi-jenkins- 
tower-light/jenkinslight.py & 


Reboot your Pi and you should be good to go! For 
maintenance, you can always SSH into the Raspberry 
Pi in the future. 


Tutorial 


Aschematic 
layout of the 
circuit board to 


control the LEDs. 

It may look a little 
complex, but just 
be careful to wire 
it up properly 


qanguage 


>PYTHON 
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Tutorial WALKTHROUGH 


RICHARD HAYLER 


Richard is a mentor at CoderDojo Ham, and 
his school CodeClub was one of the winning 
teams in the Primary Astro Pi competition 
whose code ran on the International Space 
Station in February. 
richardhayler.blogspot.co.uk 


SENSE HAT SCIENCE: Sn = — 


ue FREE-FALLING 
= WITH SENSE HAT 


sense_hat, evdev 
& select libraries 


> Something et ot Why do astronauts on the ISS float? 


to provide a metres is sufficient to 
soft landing measure free fall 


sk most people why astronauts like Tim 

Peake float around on the International Space 

Don't throw the Station and there is a good chance they’ ll 

P eet say, “Because there is no gravity.” If you think about 
it, this can’t be the case. The ISS orbits the planet at 

400km, but the Moon is nearly 100 times further away 

and is still subject to Earth’s gravitational pull. So 

why are astronauts weightless? It’s because the ISS 

is constantly in free fall, and so the astronauts living 

inside it experience weightlessness. 

This can be difficult to wrap your head around, so 

we’ ll use the Sense HAT to explain it. 

If you’ve been following the previous Sense HAT 

Science articles, this should all be familiar now: attach 

the Sense HAT to your Pi and power it up. Open IDLE3, 

or just type python3 in a terminal window, and then 

import the SenseHat library and connect to the board: 


> Acharged 
power bank 


from sense_hat import SenseHat 
sh = SenseHat() 


There are a number of ways we can measure motion, 
forces, and orientation with the Sense HAT: it has 
a gyroscope, magnetometer, and an accelerometer. 
We’re going to use the accelerometer, and the line 
of code we need probably won’t be a surprise: 


sh.get_accelerometer_raw() 


We’re using _raw() as it returns results in Gs. One 
G is equal to the force of gravity on the Earth’s surface 
Make sure you provide q (9.8m/s), and you often hear jet planes, spacecraft, and 
something soft for the ' ; : 
Pi to land on! even roller-coasters described in terms of how many Gs 

their riders experience. 

The three values measured by the Sense HAT - x, y, 
and z — correspond to the pitch, roll, and yaw axes. If 
we run the following Python snippet: 


while True: 
print(sh.get_accelerometer_raw()) 


54 | MagPi June 2016 raspberrypi.org/magpi 


... then we should see a continuous stream of the 
x, y, and z values displayed on screen. Jiggle and 
wiggle the Pi and Sense HAT around and see how the 
numbers change. Can you carefully move the Pi so 
that just one of the axis values changes? 


Taking readings 
For our experiment, we need to able to record x, y, 
and z readings constantly and save them to a file so 
that we can analyse them later. To make things easier 
(and to make our data file smaller), we will use the 
joystick to start and stop recording. There are several 
ways of doing this with Python, but the code uses the 
evdev library to register joystick presses. 
To run the experiment, power the Pi up from 
a battery pack and secure the two together 
using rubber bands or cable ties. Start the code 
and then disconnect the keyboard, mouse, and 
display cables. 
Now find somewhere from where you can drop the 
Pi. The greater the distance it falls, the easier it is to 
see the free-fall period. However, don’t forget that 
you need a big, soft landing zone! 
When you’re ready, press the joystick and you 
should see the 8x8 LED matrix light up all green. 
That means data is being recorded, so bombs away! 
Once the Pi has landed, press the joystick again to 
end the logging (the LEDs should briefly flash red, 
then turn off completely). 


Analysing the data 

For the data analysis, we can also use the Pi. Plug all 
the cables back in and start up LibreOffice Calc. The 
code conveniently writes the data into a CSV format 
that can easily be ingested by this (or any other) 
spreadsheet program, which can be used to plot 
graphs of our data. 

From the graph, you should see that before the 
drop, the Sense HAT accelerometer measures 
approximately +/-1G, then falls/rises to 0 while 
it is falling. You’ll probably also see the ‘bump’ 
corresponding to the landing (hopefully not too big). 

So, now we’ve shown that a falling object will 
experience zero G, we can see why astronauts on the 
ISS appear to float. However, if the ISS is constantly 
falling, why doesn’t it just crash into the Earth? This 
is because the Space Station is also moving ‘forward’ 
at a speed fast enough to ensure that it keeps missing 
the Earth and stays (falling) in orbit. 

You can, of course, use the Sense HAT to measure 
forces greater than 1G, too. Try taking your portable 
Pi and Sense HAT on a playground ride or, for some 
serious Gs, a theme park attraction. If you’re going 
to take your Pi and battery pack on a roller-coaster, 
though, make sure it is securely stowed away 
in a zippable pocket! 
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SENSE HAT SCIENCE: FREE-FALLING 


Tutorial 
qanquage 


e 
gravily.py =PYTHON 3 
from sense_hat import SenseHat 
from datetime import datetime 
import sys 
from time import sleep 
from evdev import InputDevice, ecodes, list_devices 
from select import select 
import logging 


DOWNLOAD: 
magpi.cc/1X0qOOu 


# Use the logging library to handle all our data recording 


logfile = “gravity-”+str(datetime.now().strftime(“%Y%m%d -%H%M”) ) +”. csv” 


# Set the format for the timestamp to be used in the log filename 
logging. basicConfig(filename=logfile, level=logging.DEBUG, 
format=’%(asctime)s %(message)s’ ) 


def gentle_close(): # A function to end the program gracefully 
sh.clear(255,0,0) # Turn on the LEDs red 
sleep(@.5) # Wait half a second 
sh.clear(0,0,0) # Turn all the LEDs off 
sys.exit() # Quit the program 


sh = SenseHat() # Connect to SenseHAT 
sh.clear() # Turn all the LEDs off 
# Find all the input devices connect to the Pi 
devices=[InputDevice(fn) for fn in list_devices()] 
for dev in devices: 
# Look for the SenseHAT Joystick 
if dev.name==”Raspberry Pi Sense HAT Joystick”: 
js=dev 
# Create a variable to store whether or not we’re logging data 
running = False # No data being recorded (yet) 
try: 
print(‘Press the Joystick button to start recording.’ ) 
print(‘Press it again to stop.’) 
while True: 
# capture all the relevant events from joystick 
r,w,x=select([js.fd],[],[],0.01) 
TOM Eden: or: 
for event in js.read(): 
# If the event is a key press... 
if event.type==ecodes.EV_KEY and event.value==1: 
# If we’re not logging data, start now 
if event.code==ecodes.KEY_ENTER and not running: 
running = True # Start recording data 
sh.clear(@,255,0) # Light up LEDs green 
# If we were already logging data, stop now 
elif event.code==ecodes.KEY_ENTER and running: 
running = False 
gentle _close() 
# If we’re logging data... 
if running: 
# Read from acceleromter 


acc_X,acc_y,acc_z = [sh.get_accelerometer_raw()[key] for key in [ 


EXains Vere Zeal] 
# Format the results and log to file 
logging. info( 
C12 OF. (2125108), (212 108}? -format(ace x, acciy,iacc_z))) 
print(acc_x,acc_y,acc_z) # Also write to screen 
except: # If something goes wrong, quit 
gentle _close() 
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Programs running in the terminal can 
be put to sleep by sending them to the 
background - from where they can 
easily be brought back with fg 


Keep an eye on your processes 
and you'llalso be able to see 
what's hogging the Pi's CPU 
and memory resources 


COMMAND LINE P! 


As close to perfect as Raspbian is, things can go wrong. In this tutorial, 
we learn that there’s no need to turn the Raspberry Pi off and on again: 


Raspbian 
raspberrypi.org 
7downloads 
- though most 
of the tutorial 
series will 
work with the 
command line 
running the 
Linux default 
Bash shell 

on any GNU/ 
Linux PC 


KEEP ON 
RUNNING 


nohup is 
useful fora 
program that 
will be running 
for some 

time in the 
background 

- perhaps a 
sensor project 
you're working 
on - until you 
feel happy 
enough to add 
it to Raspbian's 
startup 
processes. 
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just kill the process! 


ver lost the ‘off switch’ for a program? 
Sometimes software you’re running seems 
to have no inclination to stop: either you 
can’t find out how to quit, or the app has a problem 
and won’t respond to your q, CTRL+C, or whatever 
command should close it down. 
There’s no need to panic, and certainly no need 
to reboot: just identify the process and quietly kill it. 
We’ll show you how, and look at what else can be done 
with knowledge of processes. 


Processes 

Find the many processes running on your Pi with the 
ps command. On Raspbian, it’s usually called with 

the a and x switches which give all processes, rather 
than just those belonging to a user, the u switch shows 
processes by user, attaching it toa tty. wadds wider 
output, and ww will wrap over the line end to display 
information without truncating. 

Type ps auxww to see, then try with just a or other 
combinations. You’ ll notice that these options work 
without the leading dash seen for other commands. 
Both the lack of dashes, and the letters a and x, date 
back to the original Unix ps of the early 1970s; this was 
maintained through various revisions by one of Unix’s 
two family branches, BSD, and baked into the first GNU/ 
Linux ps. Unix’s other branch, System V, extended and 
changed ps with new options and new abbreviations for 
command switches, so for ps ax you may also see ps -e 
(or -ef or -ely to show in long format). 


The ps aux listing has various headers, including 
the USER which owns the process, and the PID 
(process identification number). This starts with 1 for 
init, the parent process of everything that happens in 
userspace after the Linux kernel starts up when you 
switch the Pi on. Knowing the PID makes it easy to kill 
a process, if it’s the easiest way of shutting it down. 
For example, to killa program with a PID of 3012, 
simply enter kill 3012. To quickly find the process 
in the first place, use grep on the ps list. For example, 
locating vi processes: 


ps aux | grep -i vi 


The -i (ignore case) isn’t usually necessary, but 
occasionally a program may break convention and 
contain upper-case letters in its filename. You 
can also use killa11 to kill by program name; for 
example, with killall firefox. 


Piping commands 
Naturally, you can pipe ps’s output to select the PID 
and feed directly to the kill command: 


kill $(ps aux | grep ‘[f]irefox’ | awk 
‘{print $2}’) 


We don’t have space for an in-depth look at awk 


(we’re using it here to print the second field of grep’s 
output, the PID), but the [f] trick at the beginning 
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2 8 =4648 1288 10567 8.6 6.3 9:00.82 vi 


Fig 2 htop tells you what's running, what resources it's using, and 
lets you interact with the process, even killing htop from within htop 


of Firefox (or whatever named process you want to 
kill) singles out the Firefox process. In the vi example 
above, grep found the grep process itself as well as vi 
(and anything with the letter sequence vi in its name). 

The output of ps also shows you useful information 
like percentage of memory and CPU time used, but it’s 
more useful to see these changing in real time. For 
this, use top, which also shows total CPU and memory 
use in the header lines, the latter in the format that 
you can also find by issuing the command free. For 
an improved top: 


apt-get install htop 


htop is scrollable, both horizontally and vertically, 
and allows you to issue commands (such as k for kill) 
to highlighted processes. When you’ve finished, exit 
both top and htop with q, although in htop you may 
care to practise by highlighting the htop process and 
killing it from there (see Fig 1). htop also shows load 
over the separate cores of the processor if you have a 
Pi 2 or 3. 


Background job 

Placing an ampersand after a command in the shell 
places the program in the background — try with: man 
top &and you’ll get an output like [1] 12768. 

The first number is a job number, assigned by the 
shell, and the second the PID we’ve been working with 
above. man top is now running in the background, and 
you can use the job control number to work with the 
process in the shell. Start some other processes in the 
background if you wish (by appending &), then bring 
the first - man top - to the foreground with fg 1. Now 
you should see man running again. 

You can place a running shell program in the 
background by ‘suspending’ it with CTRL+Z. fg will 
always bring back the most recently suspended or 
backgrounded job, unless a job number is specified. 
Note that these job numbers apply only within the 
shell where the process started. Type jobs to see 
background processes; jobs -1 adds in process IDs 
(PIDs) to the listing. 
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COMMAND LINE Pl 


Signals 
When we sent a kill signal from htop, we were given 
a choice of signal to send. The most important are 
SIGTERM, SIGINT, and SIGKILL. The first was the 
default when we killed from htop, and is the signal 
that kill sends if not called with a modifier. It tells a 
process to stop, and most programs will respond by 
catching the signal, saving any data they need to save, 
and releasing system resources before quitting. 

kill -2 sends SIGINT, the equivalent to stopping 
a program from the terminal with CTRL+C: you could 
lose data. Most drastic is kill -9 to send SIGKILL, 
telling the kernel to let the process go with no 
warning. Save this one for when nothing else works. 

Mildest of all is the Hang Up (HUP) signal, called 
with kill -1, which many daemons are programmed 
to treat as a call to simply reread their configuration 
files and carry on running. It’s certainly the safest 
signal to send on a critical machine. 


Staying on 

nohup will run a program which will continue after the 
terminal from which it’s started has closed, ignoring 
the consequent SIGHUP (hangup) signal. As the 
process is detached from the terminal, error messages 
and output are sent to the file nohup.out in whichever 
directory you were in when you started the process. 
You can redirect it, as we did in part 4 (issue 34), with 
1> for stdout and 2> for stderr; &> is a special case for 
redirecting both stdout and stderr: 


nohup myprog &>backgroundoutput.txt & 


One use of NOHUP for Pi users is to be able to set 
something in motion from an SSH session, that will 
continue after an interruption to that session. For 
example, restarting the network connection to which 
you are connected: 


sudo nohup sh -c "ifdown eth® && ifup ethe" 


Note that the nohup.out log file created here will 
need sudo privileges to read — or reassign with: 


sudo chown pi:pi nohup.out 


| i ey we o| 


Above Everything running has a process ID (PID) that can be used 
to control that program; find them all with ps aux 


Tutorial 


QUICKER 
BOOT 


The startup 
process of 
Raspbian is 
controlled 

by SysvVinit, 
but like other 
GNU/Linux 
distributions 
will eventually 
change to the 
new, faster 
SystemD. 

This will 
change startup 
processes, 
but 
instructions 
here will still 
be relevant. 


KEEP ON TOP 


Using a virtual 
console, it 
can be worth 
keeping htop 
running so that 
if there are 
any problems, 
you can 
CTRL+ALT+Fn 
there fora 
quick look 

- even if the 
GUI freezes. 


LEARN TO 
LOVE THE 
COMMAND 
LINE 


With 


MagPi 


Now 

available at: 
raspberrypi.org 
7magpi 


Map 
CONQUER 
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> Lisiparoi LED 
light ring 
(infrared version) 
magpi.cc/ 
1SQVFrW 


> Cyntech 
Raspberry Pi case 
magpi.cc/ 
aSQVGvW 


> Raspberry Pi NoIR 
Camera Module 


> USB WiFi adapter 


> MotionEyeOS 
magpi.cc/ 
1UCw1Jk 


> Drill and small 
drill bit (amm or 
2mm ideal sizes) 


> Small file (we 
used a metal 
nail file) 


> Pencil anda 
sharp knife (craft 
or Stanley knife) 
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WESLEY ARCHER = 
(AKA RASPBERRY COULIS) oy 


Self-taught Raspberry Pi enthusiast, 

guide writer for Pi Supply and creator of at 
raspberrycoulis.co.uk. Enjoys trying out new i a) 
Pi projects and sharing them! ne 
raspberrycoulis.co.uk / @RaspberryCoulis 4 , 


This is the Lisiparoi; it 
provides an infrared light 
source for the NoIR camera 


Inside the case is a Model B, 
the original Raspberry Pi 


RASPBERRY PI 


CAMERA HACK 


Have a spare Raspberry Pi Model B lying about? Turn it into a night-vision 
CCTV camera with this simple case hack... 


any people have a number of Raspberry Pi 

at home. Some might say those folks are 

obsessed, but Pis are so versatile that trying 
out new projects where possible is great fun! Putting 
them to good use is always exciting, so why not turn 
a spare Model B into a night-vision CCTV camera, 
using an inexpensive case, the Camera Module, and 
a nifty little accessory called the Lisiparoi to provide 
nfrared lighting? If you saw the previous guide on 
adding push notifications to MotionEyeOS (issue 43), 
then combining this with night vision would be 
a great addition! 


n 


Mark where you will cut 

Before cutting into the case, it makes things easier to 
mark it out first. Grab your pencil, place your Camera 
Module and Lisiparoi on the case, and then draw 
around them. You should be able to see the pencil 
line, and it’s easy to remove if you need to. Make sure 
you allow enough room around the outside so that it’s 
not too close to the edge of the case, though! You’ ll 
also need to cut out space for the pins on the Lisiparoi, 
holes to mount the Camera Module board, anda hole 
for the camera lens itself. 


ae 


raspberrypi.org/magpi 


>STEP-02 

Drill the mounting holes 

Using a small drill bit (1mm / 2mm is ideal), drill two 
small holes in the case. If you are very careful, you can 
use the Lisiparoi as a template. You should now have 
two small holes in the case and a pencilled outline 
of the Lisiparoi. It’s now time to drill holes for the 
header pins, which are a few millimetres away from 
the bottom edge of the Lisiparoi. It’s best to start 
small and increase the size of the holes as you go; 

it doesn’t have to be exact, as the Lisiparoi will hide 
everything once in place. 


>STEP-03 

Drill, file, test, and repeat 

Whilst doing this, remember — you can always 

cut more off! To make sure our header pins on 

the Lisiparoi fit nicely, we drilled the holes to the 
approximate width of the header and then used a 
small file to square off the holes. We then placed the 
Lisiparoi in place to see if it fit; if it didn’t, a little 
more was filed off until it did. It doesn’t have to be 
surgically accurate, since the Lisiparoi sits on top of 
the holes; even so, take your time, as you can’t undo a 
hole if it’s too big! 


>STEP-04 

Raspberry Pi NoIR Camera Module 

It?s now time to mark and cut a hole for the Camera 
Module. Again, we drew around the module with a 
pencil and then drilled small holes along the inside 
edge of the outline (otherwise the hole will be too 
big). Next, very carefully use a sharp knife to cut out 
the hole; the drilled holes along the outline should 
help with this step. Make sure this is done on a tough, 
steady surface (we used an old chopping board). Fine- 
tune the fit by filing the hole and testing that the 
Camera Module fits. Repeat until it does. 


As the old adage goes, ‘measure twice, cut once’. 
If in doubt, cut smaller and file away to fit 
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NIGHT VISION CAMERA 


motionEye @| 


>STEP-05 

Put everything together 

Now that the holes are all cut and fit nicely, it’s time 
to put everything together. Make sure you’ve soldered 
the header onto your Lisiparoi first, though! The 
header needs to be soldered so the pins are on the 
inside of the case and pointing downwards, so that 
the jumper cables can be fitted to the Pi’s GPIO once 
fully assembled. Screw your nuts and bolts together 
and connect up your cables, including the ribbon 
cable for the Camera Module. For more information 
on using the Lisiparoi, including wiring diagrams, 
check out the official site here: magpi.cc/1SQWvoo. 


>STEP-06 

Install MotionEyeOS and test everything 

If you have connected the Lisiparoi so that it turns 
on whenever the Pi does, then you just need a 

CCTV operating system. MotionEyeOS is perfect 

for this, because it’s simple to use and works 

very well! Download the relevant image from 
magpi.cc/1UCwiJk, then write it to your SD card. You 
won’t be able to see if the infrared LEDs are on, but 
test it out in the dark and you should see more than 
you would normally without them! As the LEDs are 
small, they’re not very powerful, but should provide 
enough illumination to see better in the dark! 


Tutorial 


Left Once it's 
complete, you 
should hopefully 
see something 
like this from 
your Raspberry 
Pi night-vision 
CCTV camera! 


MEASURE, 
THEN 
MEASURE 
AGAIN! 


They always 
say ‘measure 
twice, cut 
once’, and so 
do wel! It is 
better to be 
safe than sorry. 


LESS IS 
MORE 


You can always 
cut more, but 
you cannot 
replace what 

is gone. Think 
about this 
when drilling 
and filing! 
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Tutorial 


A bar chart 


shows the audio 


frequencies 


Built on stripboard, the 
Spectrum visualiser 
features four chips 


> 2x MSGEQ7Z 
equaliser chip 


> 1x MCP602 
operational 
amplifier 


> 1x MCP3002 
2-channel, 10-bit 
A/D converter 


> 4x 8-pin DIL 
sockets 


> 2x 3.5mm board 
mounting stereo 
jack sockets 


> 1x 28-hole by 19- 
hole stripboard 


> 1x 26-way GPIO 
header socket 


> Assorted 
resistors, 
capacitors, 
and wires 
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Turn any sound source into a stunning graphics display 


onverting sound to lights has always been a 

popular project, although there is little in the 

way of Raspberry Pi versions, so this month 
we thought we would remedy that. This project uses 
the popular MSGEQ7 chip, which is officially obsolete 
but still widely available. This chip has seven second- 
order, switched capacitor, analogue filters built into 
it that cover the audio spectrum. These filters peak at 
65Hz, 160Hz, 400Hz, 1kHz, 2.5kHz, 6.25kHz and, for 
those youngsters still lucky enough to hear that high, 
16kHz. The frequency response is shown in Fig 1 (page 
64); note that both the frequency and the output are 
plotted on a log scale. This ensures that the response 


looks like 
sensing o 


it sounds, because of our logarithmic 
f both frequency and loudness. 


The actual peak frequency of each filter depends 


on the bu 


ilt-in oscillator that is set with an external 


resistor and capacitor, 200kQ, and 33pF respectively. 


The chip 


takes in an audio signal and passes it through 


these seven filters. However, the chip has only one 


output: it 
each filte 


>s an analogue signal that gives the output of 
r in turn, as you feed it clock pulses. The fact 


that the Pi has no built-in analogue input is probably 
why there’s not many Pi projects using this chip. 


To get rou 
featured i 


nd this, we used the MCP3002 chip that 
n last month’s project. 
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SPECTRUM SHOW 


Tutorial 


3V3 


Strobe 


GPIO 10 
GPIO9 
GPIO 11 
GPIO 8 


Gnd 


Strobe 


GPIO 24 


The hardware 

As we wanted a Stereo display, we used two of these 
MSGEQ7 chips, one for left and the other for right. 
We found that the MSGEQ7 chip required an audio 
input of about 0.6V PTP (peak-to-peak) to get the full 
output signal, and while that could be provided by an 
iPad going absolutely full blast, the audio signal from 
the Pi itself was not so large. Therefore we decided 

to put a x10 amplifier between the audio source and 
the MSGEQ7. We had two audio jack sockets wired in 
parallel so the spectrum board could be used in pass- 
through mode. That is, the audio input was connected 
to one socket and the other socket could be connected 
to your headphones or input to your audio amplifier / 
speaker system. As the MSGEQ7 is capable of being 
run at 3V, this made the interfacing of the digital 
clocking signals easy. Each MSGEQ7 is fed into a 


separate input channel of the MCP3002 A/D converter. 


The full schematic is shown in Fig 2. 

The MCP602 has, conveniently, two amplifiers in 
it with aclose to rail-to-rail output, and will work 
off a single 3V rail. If you are substituting other 
operational amplifiers here, make sure that they meet 
that specification. The gain of 10 is given by the 10kO, 
resistor between pins 1 & 2 for the right side and pins 
6 &7 for the left side. If you need to increase the gain, 
just increase this resistor value; for example, a 47kQ. 
resistor will give a gain of 47 times. As the amplifiers 
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are running off a single rail, you need to generate a Fig 2 The 


virtual ground; luckily this is generated on pin 6 of 
the MSGEQ7. The 16yF input capacitor value is not 
very critical, and you could use anything between 
10uF and 100uF here. 

The strobe and reset pins for producing the different 
filters’ output from the chip are directly connected 


As we wanted a stereo 
display, we used two of 
these MSGEQ7 chips 


to the GPIO pins. The MCP3002 is connected to 

the SPI bus, just like last month’s project. Full 
construction details are given in the step-by-step 
section (pages 62-63). Note that if you’re trying to 
adjust the 200kQ resistors and 33pF capacitors to give 
you a 165kHz oscillator exactly, you can’t just put an 
oscilloscope on pin 8. This is because the capacitance 
of most affordable oscilloscope probes will become 
part of the oscillator circuit and change the frequency. 
You need to measure that the frequency of a channel 
peak is correct, to make sure the oscillator is at the 
correct frequency, but this is not too critical. We 
would advise you to study the data sheet of this chip. 
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schematic of the 
Spectrum board 


61 


Tutorial 


WALKTHROUGH 


Underside of Board 


The software 

As well as having WiringPi installed, you need to 
enable the SPI drivers — see last month’s project for 
details if you haven’t already done this. The software 
in the Spectrum.py listing (pages 64-5) is written in 
Python using the Pygame framework. It can run in 
debug/full-screen mode or in whole-screen mode. The 
full-screen mode still has the window bar and icon 
bar visible, whereas whole-screen has nothing but the 
display. However, any Python error that occurs in the 
full-screen mode could lock up your system, so set it 
to debug mode to begin with. When not in the debug 
mode, the display can be toggled between full-screen 
and whole-screen with the space bar. This is useful if 
you’re using the Pi as a source of the audio, to allow 
you to change tracks and make a playlist. We used VLC 
for this, but there are other audio players available. 
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x Drill 1mm hole 


>STEP-01 

Preparing the stripboard 
The diagram shows the strip 
side of the board. Take a piece 
of 28- by 19-hole stripboard and 
drill four 3mm holes in each 
corner, one hole down and in 
from each corner. Next, drill six 
1mm holes where the black holes 
are, to accommodate the two 
stereo jack sockets. The position 
might change if you haven't got 
the same sort of socket that 

we used. Finally, cut the strips 

in the position indicated by the 
grey rectangles. 


raspberrypi.org/magpi 


>STEP-02 

Building the stripboard 

This diagram shows the component side 
of the boards with the strips shown as 
hidden details. Use solid copper links 
for the straight jumpers and then add 
the IC sockets. Fit the resistors and 
capacitors. Note the ceramic capacitors 
all fit on adjacent tracks, so you can 

use surface-mount capacitors on the 
underside of the board if you want. The 
200kQ resistor was formed by standing 
up two 100kQ resistors and connecting 
the tops; this is because we didn’t have 
any 200kQ resistors to hand, although 
you can get away with one here. Finally, 
place the flexible wires on the board. 


>STEP-03 

Attaching to the Pi 

The photograph shows the finished 
board. All that remains is to attach it 

to the GPIO pins of the Pi. There are 
many ways to do this; we used a 26-way 
header so that it would fit on any Pi. We 
used 30cm of eight-way ribbon cable to 
attach the header to the Spectrum board. 
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Tutorial 


GPIO 23 
GPIO 24 
GPIO 11 

GPIO 09 
GPIO 10 
3V3 


GND 
GPIO 08 
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Tutorial WALKTHROUGH 


S 33. random.seed() 


35. rightData = [ 60,70,80,90,80,70,60 ] 


Q@1. # Spectrum - Sound visualiser 36. colowir = [((255;,,0,0).,.(255,,645.0).;(128,,255,,0),.(255,,255,,) 5 (( 
@2. # By Mike Cook - April 2016 @,114,141), (18,0, 237), (255,0,255)] 
63. 37. if debug : 
04. import pygame, time, os, random 38. noiseFloor = [[0,0,0,0,0,0,0],[0,0,0,0,0,0,0]] 
05. from pygame.locals import * 39. else : 
06. import wiringpi2 as io 40. noiseFloor = [[57, 55, 58,, 60, 71, 103, 124], [ 
@7. 47, 72, 85, 86, 101, 136, 201]] 
08. pygame.init() # initialise graphics interface 41. rawData = [[0,0,0,0,0,0,0],[0,0,0,0,0,0,0] ] 
09. pygame.mixer.quit() 42. 
10. pygame.mixer.init( 43. textHeight = 36 
frequency=22050, size=-16, channels=2, buffer=512) 44. font = pygame.font.Font(None, textHeight) 
11. enclosureSound= [ pygame.mixer.Sound( 45. 
"sounds/"+str(c)+".ogg") for c in range(@,10)] 46. def main(): 
12% 47. initGPIO() 
13. debug = False 48. while True: 
# debug with window bar, display numbers and raw data 49. checkForEvent() 
14. screen = pygame.display.set_mode((@, @)) 50. getSpectrumData() 
# with window bar - use for debugging 5 plotData() 
15. xs, ys = screen.get_size() B25 
16. fullScreen = False 53. def getSpectrumData(): 
17. if not debug : 54. # set up the chip to read in the data 
18. pygame.display.toggle fullscreen() 55 global leftData, rightData 
19% fullScreen = True 56. io.digitalWrite(pinReset, 1) 
20. else : Bilis io.digitalWrite(pinClock,1) 
Dale ys -= 66 58% time.sleep(0.001) 
22. pygame.display.set_caption( “Spectrum Sound Show") 59) io.digitalWrite(pinClock,®@) 
23) 60. time.sleep(0.001) 
24. posX = xs / 16 61. io.digitalWrite(pinReset, 2) 
25. backl = pygame.Surface(screen.get_size()) 62% io.digitalWrite(pinClock,1) 
26. errase = pygame.Surface(screen.get_size()) 63. time.sleep(0.004) 
Dies 64. # now read in each channel in turn 
28. pygame.event.set_allowed(None) 65. for s in range(Q,7): 
29. pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT]) 66. io.digitalWrite(pinClock,®@) 
30. 67. time.sleep(@.004) # allow output to settle 
31. pinReset = 23 68. leftData[s] = scaleReading(io.analogRead(70),s,@) 
32. pinClock = 24 69. rightData[s]= scaleReading(io.analogRead(71),s,1) 
Fig 1 The frequency 
response of the 


MSGEQ7 chip 


20 


Output dB 


Frequency Responce Log Hz 
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SPECTRUM SHOW 


70. io.digitalWrite(pinClock, 1) 103. 
TAN 104. def initGPIO(): >PYTHON 2.7 
72. def scaleReading(reading, band,side): 105. try = 
Tek # adjust for screen size and noise floor 106. io.wiringPiSetupGpio() DOWNLOAD: 
74. global rawData 107. except : magpl.cc/aNqJjmv 
disk if debug : 108. print"start IDLE with 
76. rawData[side][band] = reading "gksudo idle’ from command line" ened 
ihe reading -= noiseFloor[side][band] 109. os._exit(1) 
78. if reading <@ : ENON io.pinMode(pinReset,1) Check out Mike's 
79. reading = @ Table io.pinMode(pinClock, 1) Bakery videos at: 
‘ ; magpi.cc/1NqJnTz 
80. scaled = (float(reading) / ( 1112" io.mcp3002Setup(702,2) 
1024.0 - float(noiseFloor[side][band]))) * ys alas} 
81. return int(scaled) 114. def terminate(): # close down the program 
82. AHS print ("Closing down please wait") 
83. def plotData(): d'6% if debug : 
84. # display volume bars al L7As print rawData 
85. global leftData, rightData 118. pygame.quit() # close pygame 
86. pygame.draw.rect(screen, (9,0,08),(0,0,xs,ys),@) 19). os._exit(1) 
87. for band in range(@,7): 1120). 
88. pygame.draw.rect(screen, colour[ 121. def checkForEvent(): # see if we need to quit 
6-band], ((band+1)*posX, ys-leftData[6-band],posX-20,ys),@) 122. global fullScreen 
89. pygame.draw.rect(screen, colour[band], (( 1235 event = pygame.event.poll() 
band+8)*posX, ys-rightData[ band], posX-20,ys) ,@) 124. if event.type == pygame.QUIT : 
98. if debug : 12:5; terminate() 
or. drawWords(str(leftData[6-band]),(band+1)*posx,@) 126. if event.type == pygame.KEYDOWN : 
92°. drawWords(str(rightData[band]),(band+8)*posx,@) 127. if event.key == pygame.K_ESCAPE : 
O3% pygame.display.update() 128. terminate() 
94. DOF if event.key == pygame.K_SPACE and not debug: 
95. def drawWords(words,x,y) : 130. pygame.display.toggle_fullscreen() 
96. textSurface = pygame.Surface(( alg hilic fullScreen = not fullScreen 
len(words)*12,textHeight) ) 32% 
ST. textRect = textSurface.get_rect() 133. # Main program logic: 
98. textRect.left = x 134. if _name_ == '_main_': 
99% textRect.top = y 135250 Gny: 
100. pygame.draw.rect(screen, (81,133,133), ( 136. main() 
x,y, len(words)*12,textHeight-10), @) 1372. except: 
101. textSurface = font.render( LS Sr if fullScreen : 
words, True, (180,180,180), (81,133,133)) 139) pygame.display.toggle fullscreen() 
102. screen.blit(textSurface, textRect) 140. 


The display we chose to implement is a simple bar 
display with the left channel as the mirror image of 
the right one. This means that the lowest frequency 
is at the centre of the screen, and the highest at the 
edges. The colour of each bar is set by the colour list of 
RGB tuples. As the program can be run on any size of 
window, everything is worked out from the screen size 
once the full-size window has been created. 

With any analogue system there’s always noise; the 
display looks better if no sound equals no display. To 
do this, there is anoiseFloor list of values for each 
side that’s subtracted from the MSGEQ7’s readings 
before display. This is initially set to all zero values, 
but when you quit from the debug mode, a list of the 
output values is printed. If you quit with no audio, 
these values can be pasted directly in the code that 
sets the noiseFloor list for the non-debug mode. 
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Taking it further 

We found it best to use an external sound source such 
as an iPad, so that you can easily trim the volume to 
compensate for quiet or noisy music. We found that 
the best type of music was any with a good dynamic 
range and beat. 

With regards to altering things, the simplest thing 
you can do is to change the colours of the bars and 
the way they’re displayed. For example, the colours 
could change as the bars get higher. However, you 
might want to take it further and change the way 
the amplitude values are displayed. They could be 
used to control the drawing of an abstract figure or 
an animation. The display or the colours could be 
made to change after a set time. Alternatively, you 
could drive a string of NeoPixels to generate a bright 
external display. 
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Tutorial 


The Wii Balance Board 
is a Bluetooth scale 
that can be controlled 
from a Python script 


Weight measurements 
are sent to your 
dashboard on Initial 
State's website 


Asnarky yet 
informative SMS is 
sent every time you 
weigh yourself 


JAMIE BAILEY 


Jamie is an electrical/system engineer, 
integrated circuit designer, and CEO/ 
founder of Initial State, a data analytics 
service for Internet of Things devices. 
initialstate.com 


+1 (615) 823-2279 


If you are what you eat, perhaps you should eat a 
skinny person. ( You gained 0.5 Ib since last ... 


BUILD A WEIGHT-TRACKIN 


> Wii Balance 
Board 

> Wii Fit 
rechargeable 
battery pack 


> %" Felt pads 


> Pencil 


The Wii 

Balance Board 
pairs with your Pi 
through Bluetooth, 
making it easy to 
read your weight 
with a script 
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Connect a set of scales to the web that tracks your weight 
and sends you text message updates with an attitude 


h, that boring, soulless bathroom scale. 

We love to hate you when you don’t show 

us that number we want. We swear at you, 
as if you’d care. Why hasn’t anyone made a scale 
that’s actually fun to usee It’s time to create a scale 
that’s not only smart, but has a bit more personality 
to brighten your day. We’re going to build our very 
own hackable, weight-tracking, text-messaging 
bathroom scale that comes with a built-in sense 
of humour. 


Setting up the Wii Balance Board 
As the Raspberry Pi 3 comes with Bluetooth built 
in, it makes it very easy to communicate with the 
Wii Balance Board. If you have a Raspberry Pi1 
or 2, you’ll need to use a USB adapter such as the 
inexpensive iAnder USB Bluetooth 4.0 Low Energy 
adapter (magpi.cc/1iNqI6mj). 

Power on your Pi and open up a terminal window. 
You can see the address of your Bluetooth dongle by 
entering the following command: 


hcitool dev 


Install the Bluetooth modules that we will be using 
in our Python scripts: 


sudo apt-get install python-bluetooth 
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Update 


0 


Data 


Settings Sf) 


Triggers Sharing # Edit Tiles 


Mon 07 
match |b 


+19999999999 


If you are what you eat, perhaps you should eat a skinny person. @ You gained 0.5 Ib since last time (189.5 | 


q 
” 


* my weight history 
03/06/2016 03:12AM : 


Wed 09 Thu 10 Mar 13 M Tue 15 Wed 16 


03/18/16 8:12 AM 


Set up SMS notifications and track 
your weight over time in Initial 


State’s web-based dashboard 


After installation completes, we’re ready to connect 
and communicate with the Wii Balance Board. We 
won’t be permanently pairing our Board with our Pi, 
like we do with most of our Bluetooth devices. The Wii 
Balance Board was never intended to be paired with 
anything other than a Wii. Pairing will happen every 
time we run our Python script. 

It’s time to connect our Wii Balance Board to our 
Raspberry Pi. We’ll do this by running a Python script. 
To get the scripts we’ll use for this project, clone the 
GitHub repo: 


cd ~ 

git clone https://github.com/InitialState/ 
smart-scale.git 

cd smart-scale 

1s 


You should see two Python files in the new 
smart-scale directory: smartscale.py and 
wiiboard_test.py. Run the wiiboard_test. py script 
to test communication and take weight readings 
from the Wii Balance Board: 


sudo python wiiboard_test.py 
You’ll see the following response: 


Discovering board... 
Press the red sync button on the board now 


Remove the battery cover underneath the Wii 
Balance Board to locate the red sync button. Make 
sure that you press the button within a few seconds 
of running the script or a timeout will occur. Once 
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successful, you’ll see something similar to the 
following on rhe screen: 


INITIAL 
STATE 


Found Wiiboard at address 
Q0:23:CC:2E:E1:44 

Trying to connect... 

Connected to Wiiboard at address 
@0:23:CC:2E:E1:44 

Wiiboard connected 

ACK to data write received 

84.9185297 lbs 

84.8826412 lbs 

84.9275927 lbs 


You have now successfully converted your Wii 
Balance Board into a Raspberry Pi-connected scale. 
Now, let’s make it a cool scale. 


Create a hacky lever to access the sync 
button on the bottom of the Board, 
using a pencil and a few 3%’ felt pads 
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support jamie@initialstate 


03/18/2016 04:12 AM 


Thu 17 


Tutorial 


WALKTHROUGH 


Above The Wii 
Fit rechargeable 
battery pack 
allows you to 
constantly power 
your scale from 
a wall outlet, to 
avoid having to 
do a Bluetooth 
sync each time 
you weigh 


ADD YOUR 
OWN HACKS 


You can 
faateXeliavasal= 
messages that 
get sent, the 
units used for 


measurement, 
and even add 


your progress 
toward your 
own weight 
loss goals by 
modifying 
the existing 
Python script. 


Hardware tweaks 

Nintendo assumed you would always power your 

Wii Balance Board with four AA batteries and so 
included no AC power adapter. Having only battery 
power would be inconvenient because we cannot 
permanently pair our Wii Board to our Pi through 
Bluetooth. We need to sync it, then allow it to remain 
synced without draining the batteries, so that we can 
simply step on the scale and weigh. Luckily, there are 
several third-party adapters made for the Wii Balance 
Board that we can use to provide constant power from 
a wall outlet. The Wii Fit Rechargeable Battery Pack 
(magpi.cc/1NqIEIT) is a perfect solution to our power 
problem. Replace the batteries with this battery pack, 
and plug the AC adapter into a wall outlet. 

Having to pair the Wii Balance Board and Raspberry 
Pi every time we run our Python script presents 
another inconvenience due to the location of the 
sync button. The sync button is at the bottom of the 
Wii Board, which means we would have to flip it over 
every time we sync. We can fix this by making a hacky 
little lever using a pencil and three %” felt pads. The 
rechargeable battery pack exposes the sync button to 
the underneath surface of the Board. Tape a pencil (or 
something similar) that runs from the sync button 
to the outside front of the Board. Stack three %’ felt 
pads (or something similar) on the centre(ish) of the 
pencil to create a stationary pivot. Flip the Board over 
and you can press the sync button by simply pressing 
down on the lever. Hacky but effective. 


Initial State 


We want to stream our weight/data to a cloud service 
and have that service turn our data into a nice 
dashboard that we can access from our laptop or 
mobile device. Our data needs a destination; we’ll use 
Initial State as that destination. 

Go to magpi.cc/1TFlhaz and create a new account, 
then install the Initial State Python module onto your Pi: 


cd ~ 
\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


When prompted to automatically get an example 
script, type Y. This will create a test script that we can 
run to ensure that we can stream data to Initial State 
from our Pi. Run the test script to make sure we can 
create a data stream to your Initial State account: 


python is_example.py 


Go back to your Initial State account in your web 
browser. A new data bucket called ‘Python Stream 
Example’ should have shown up on the left in your 
bucket shelf. Click on this bucket and view it in the 
visualisation apps Tiles, Waves, and Lines. 

You are now ready to start streaming real data from 
your scale. 


The final script 

The final script that puts everything together is called 
smartscale.py, in your ~/smart-scale directory. A few 
settings need to be set in the script before you can run 
it. Open up smartscale.py in your favorite text editor, 

such as nano: 


cd ~ 
cd smart-scale 
nano smartscale.py 


Near the top of this file, there is a User Settings 
section. These are all of the settings that you can 
tweak to your taste. The only setting you have to set is 
your ACCESS_KEY, which is your Initial State account 
key. If you don’t put your ACCESS_KEY in this field, 
your data won’t show up in your account. Go to your 


Right Receive a 
variety of funny, 


inspiring, and Trigger: ‘Update’ was '! enjoy long, 


Trigger: ‘Update’ was ‘You gained 0.85 
Ib since last time (191.45 Ib). You 
probably just forgot to go to the gym. 


Trigger: 'msg' was ‘You are in shape ... 
round is a shape @. You gained 4 Ibs.’ 


insulting SMS romantic walks to the fridge. 191.3 Ib That's like what, 8 years in a row now? 
messages from (-0.13 Ib change)* *" 
your smart scale Trigger: 'Update' was ‘Guys that wear 


skinny jeans took the phrase, getting 
into her pants, the wrong way. fl You 
weigh 191.1 Ib!’ 


Trigger: 'Update' was ‘After exercising, | 
always eat a pizza ... just kidding, | don’t 
exercise. “{ You gained 1.34 Ib since 
last time (193.38 Ib). 


Trigger: 'Update' was "You're getting so 
skinny that if someone slaps you, they “Il 
get a paper cut. ©) You lost 4.61 Ib 
since last time (171.67 Ib).’ 

Trigger: 'Update' was ‘If you were words 
on a page, youd be what they call FINE 
PRINT! LJ You lost 1.09 Ib since last 
time (153.58 Ib).’ 


Trigger: ‘Update’ was 'How do | like my 
eggs? Umm, in a cake. — You weigh 
192.07 Ib!" 


Trigger: 'Update' was ‘I know milk does a 
body good, but damn, how much have 
you been drinking? @ You lost 1.32 Ib 
since last time (75.04 Ib). 
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Tutorial 


Value 


Example Log 


Stream Done 


»_ MQ 
. python stream example 
c Miy B My Numi 


Value 


true 


i © 


Luckily, there are several third-party adapters 
made for the Wu Balance Board that we can use 
to provide constant power from a wall outlet 


Initial State account in your web browser, click on your 
user name in the top-right, then go to ‘My Account’. 
You’ll find your access key at the bottom of the page, 
under ‘Streaming Access Keys’. 

Once you have specified each parameter in this 
section and saved your changes, you’re ready to run 
the final script: 


sudo python smartscale.py 


Step on the scale to take a measurement. Go to your 
Initial State account and click on the new data bucket 
with the name corresponding to the BUCKET_NAME 
parameter (i.e. My Weight History). Click on Tiles to 
view your weight history dashboard. You can customise 
your dashboard by resizing and moving tiles, as well as 


changing view types and even adding tiles. 


SMS setup 
Let’s create a SMS alert whenever the scale takes a 
weight measurement. First, make sure your weight 
history data bucket is loaded, then click on the 
bucket’s settings in the data shelf (under its name). 
Click on the Triggers tab; if you don’t see a Triggers 
tab, make sure you’re subscribed to an Initial State 
account plan that allows Triggers. 

Select the data stream to trigger on; you can use 
the drop-down list to select from existing streams 
once a data bucket has loaded, or you can type in the 
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stream name/key manually. Select the ‘Update’ data 
stream and then select the conditional operator, in 
this case ‘match’. Select the Trigger value that will 
trigger an action (manually type in the desired value). 
Type in lb if you are using imperial units, or type in kg 
if you are using metric units. Whenever the Update 
stream contains ‘lb’ (or ‘kg’), you will get a text 
message notification. 

Next, click the ‘+’ button to add the Trigger 
condition. Select the action (‘notify by SMS’) and 
then click the ‘+’ button to add the action. Input any 
verification code, if adding a new phone number, to 
complete setup. 

Your trigger is now live and will fire when the 
condition is met. Click Done to return to the main 
screen. Every time you weigh yourself, you will get 
an SMS that contains your weight, how much it has 
changed since the last measurement, and a random 
joke, insult or compliment. 


Customisation 

Not a fan of the humour built into this project? You 
can change the jokes in the messageWeighFirst, 
messageWeighLess, messageWeighMore, and 
messageWeighSame functions to whatever wacky 
brand of humour you have. You can also stream data 
from other sources into the same weight history 
dashboard to create your own personal health 
dashboard. Hack away. 


Count 


pop 


Run a test 
script from your 
Pi to make sure 
you can create 
a data stream 
to your Initial 
State account 


ADD MORE 
DATA 
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Tutorial 


Adisassembled USB power 
bank provides power and 
can be easily recharged 


The Slice of Radio transmits 
messages over the Pi's serial 


> Large RC car 
controller 


> Slice of Radio 
magpi.cc/ 
1W7Sphx 


> XinoRF 
magpi.cc/ 
1QSdoyo 


> USB power bank 
magpi.cc/ 
1W7UZE6 


> Toggle switch 
magpi.cc/ 
aW7VPKL 


> Hook-up wire 


> Micro USB cable 


PREVENT 
SHORT 


CIRCUITS 
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JAMES LACEY 


15-year-old Raspberry Pi 
enthusiast and Lego lover. He 
often makes projects using both. 
jamesLtk 


WITH PI ZERO 


Control an Arduino- powered custom Lego car with a simple 
remote control and a Raspberry Pi Zero 


ver wanted to use a Raspberry Pi to remotely 

control an Arduino, but using something 

smaller and more portable than a keyboard? 
Here we’ll show you how to add a Pi Zero and wireless 
radio to acontroller from an RC toy, turning it into a 
versatile and customisable project controller! 


Prepare the controller 

Open up the controller by removing any screws 

and plastic retention clips. Locate and remove the 
main PCB of the controller. You will see contacts 

on the PCB, which the joysticks or buttons on the 
controller touch to send signals to the integrated 
circuit (IC) on the board. Using a multimeter, you 
should be able to follow each contact to a pin on 

the main IC. On this controller there are four contacts, 
so four IC pins should be found and labelled. 


Remove the main IC 

The IC will probably be soldered to the PCB, so cut off 

all the legs with pliers and desolder all the legs from 

the board. Now is also the time to remove other large 
components from the PCB that may interfere with the 
placement of the Pi Zero. Remembering which pin hole 
connects to which IC, solder differently coloured wires 

to each hole and the other half of the contacts (which 
are usually connected via a common trace). It’s now time 
to prepare the Pi Zero. 


Preparing the Raspberry Pi 

Solder on only the first ten pins of a male GPIO 
header to the Pi Zero, so the serial pins are populated 
with connectors. Leave the rest of the GPIO holes 
unpopulated so you can solder on the pin connectors. 
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Prepare a microSD card with Raspbian Jessie Lite on it, 
then connect to an HDMI monitor, mains power, anda 
keyboard to run raspi-config. Next, get the code from 
the GitHub repository (magpi.cc/1QSep84) and place it 
in your home directory. 


>STEP-04 

Wiring up the Pi 

If you are using the code without alterations, solder 
the contact for the forward position to GPIO 27, the 
backward contact to GPIO 22, the right contact to GPIO 
23, and the left contact to GPIO 24. Connect the other 
half of each contact to a 3.3V pin. Bend over the wires 
so they are as flush with the PCB as possible, so you 
can still attach the Slice of Radio transceiver. Turn 

on the Pi and run the code; the HDMI monitor should 
display no signal, and the LEDs on the Slice of Radio 
should flash when you move the levers. 


>STEP-05 


Running the code at boot 

Edit the /boot/cmdline.txt file to include the line 
"init=/home/pi/filename-of-code.sh". Verify 
that the code is correct and chmod +x the script. This 
is your last chance to change anything — the Pi will 
not boot to a terminal again without manual editing 
of cmdline.txt. Disconnect your HDMI monitor 

and keyboard, then reboot the Pi Zero. The LEDs on 
the Slice of Radio should flash to show that data is 
being transmitted. 


>STEP-06 

Fitting the Pi in the controller 

You may have to use a Dremel tool or wirecutters/ 
pliers to remove parts of the internal structure of the 
controller, so that the Pi fits. We had to remove most 
of the battery compartment. After fitting, check that 
all the wires are still securely attached to the Pi and 
the controller. Test the controller again, ensuring the 
LEDs flash. You’ve completed most of the controller, 
but if you have sufficient space available, continue to 
the next step to get rid of that annoying power cable. 


>STEP-07 

Fitting the battery 

Prise the two halves of the power bank apart with 

a knife or screwdriver. You should see a cylindrical 
battery and a small PCB with a USB and micro 

USB socket. Remove these from the housing and 
desolder the large USB socket from the board. 
Using a multimeter, find and label the positive pad 
that the USB socket was soldered to. Cut off the large 
USB plug from the micro USB cable, then solder the 
red wire to the positive pad and the black wire toa 
terminal of the switch. Connect the other terminal 
to the negative pad on the PCB. Make a hole in the 
controller for the micro USB connector and glue 

it in place. You’re done! 
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HACK A REMOTE CONTROL 


controt.sh 


#!/bin/bash 
# put this code in /etc/rc.local to execute at boot DOWNLOAD: 
mount /dev/mmcb1k@p2 / -o remount,ro # prevent SD magpi.cc/10Sep84 
card corruption by mounting read-only 

mount proc /proc -t proc # as this is executed just 
after the kernel has finished booting, /proc doesn't exist. This creates it. 
tvservice -o # Turn off HDMI 

stty -F /dev/ttyAMA@ 9600 # set the baudrate of the Slice of Radio 

gpio -g mode 27 down # configure internal pull ups 

gpio -g mode 22 down 

gpio -g mode 23 down 

gpio -g mode 24 down 

TTY=/dev/ttyAMA@ 

while true; do 

A=0 

B= 

c=0 

D=0 

[L $(gpio -g read 27) == 1 ]] && A=1 # forward 

[L $(gpio -g read 22) == 1 ]] && B=2 # backward 

[[ $(gpio -g read 23) == 1 ]] && C=4 # right 

[[ $(gpio -g read 24) == 1 ]] && D=8 # left 

SWSTATE=$ ( ($A+$B+$C+$D) ) 

case $SWSTATE in 


@) 

echo "aAASTOP----- "> $TTY # stop and center, as there is no input on any switch 
echo "aAACENTER---" > $TTY 

sleep 0.5 

33 

1) 

echo "aAAFORWARD--" > $TTY 

echo "aAACENTER---" > $TTY 

33 

2) 

echo "aAABACKWARD-" > $TTY 

echo "aAACENTER---" > $TTY 

33 

4) 

echo “aAASTOP----- Se Stile 

echo "aAARIGHT----" > $TTY 

33 

5) 

echo "aAAFORWARD--" > $TTY 

echo "aAARIGHT----" > $TTY 

33 

6) 

echo "aAABACKWARD-" > $TTY 

echo "aAARIGHT----" > $TTY 

33 

8) 

echo "aAASTOP----- “> SITY 

echo "aAALEFT----- See SING 

33 STRENGTHEN 
9) WEAK 
echo “aAAFORWARD--" > $TTY SOLDER 
echo "aAALEFT----- be eS URSICING JOINTS 

Br 

10) Use glue to 
echo "aAABACKWARD-" > $TTY strengthen 
echo "aAALEFT----- “> SY. weak solder 
3 joints that 
*) may break off; 
echo "DEBUG: $SWSTATE" # print to a debug terminal if erly 
there is an unknown option hot glue gun. 
ad. 

esac 

done 
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SET UP & USE THE 
RASPBERRY PI 


ORACLE 


WEATHER STATION 


The new weather station kit is making its way 
to schools - here’s how to set it up, plus a 
taste of what you can do with it... 


ast month in The MagPi, 
we reported on how the 
long-awaited Raspberry 


Pi Oracle weather station was 
making its way to schools, with 
an initial shipment going out to 

a select few in the UK. Since then, 
more have been sent out and 
more schools have been receiving 
them, ready to do some weather 
science using the power of a little 
Python code. 

We’ve put together a little 
guide based on the information 
freely available from the 
Raspberry Pi resources website 
(magpi.cc/1qEg9Nh), to help you 
build your station and then use 
it to take some measurements. 
In the future, hopefully, more 
people — not just schools - will 
be able to take advantage of 
the educational potential of the 
weather station kit. 
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ORACLE WEATHER STATION ficeelillir2 


BUILD YOUR 
WEATHER fee 
STATIO 


Grab a screwdriver and let’s get constructing! 


can be found online: 


magpi.cc/1YprQSO 


01 - ATTACH THE HAT 
needs to be inserted 


into the HAT while you're The weather station is made up primarily of a HAT (which 
attaching it to the Pi 

is two boards that can split up if needed) and sensors. We 
begin by attaching the HAT to the Raspberry Pi; first, add 
the GPIO extender and then screw in the spacers on the 
Raspberry Pi, as shown in the image. Once they're secure, 
align the HAT on top in the orientation shown and then 
screw it to the spacers. Finally, insert the battery. 


The coin cell battery 


week 


7 ff 


O02 - CONNECTING THE BOARDS 


To make sure the 
GPIO pins can 
reach the HAT 
once attached, 
an extender is 
included which 
should be attached 
before screwing 
the HAT into place 


The weather station HAT is made up of two pieces: the 
weather board, which is the main HAT, and the air sensor 
board. They're not actually connected by any circuits, 
because you can have them separate for specific uses. 
So, to get them to communicate, you need to use an RJ11 
cable and insert it into the ports shown in the image. 


The cable allows for data 


The spacers keep the to be communicated between 
es ie a the the air sensor board and the 
‘aspberry Pi @ main weather board 


i 
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03 - SENSING TEMPERATURE 04 - WIND SENSORS 


The wind-speed sensor is the 
device with the three ‘cups’ on 
struts, while the weather vane 


The temperature sensor is attached to the air sensor The anemometer, or wind-speed 
has a flat paddle on one end 


portion of the board via the remaining port. The cable sensor, can be connected to the 


allows it to be placed away from the Raspberry Pi. weather vane or plugged directly 
into the HAT. We want to use all 
the sensors, so make sure it's 


A basic plugged into the weather vane 
temperature : 7? 
probe that can and then plug that directly into the 


be used outside weather station HAT in the middle 
for sensing 
weather, or of the three ports. 
elsewhere if you 
have a different 
use in mind 


05 - RAIN GAUGE 


The final sensor to plug in is the rain 
gauge, which allows you to measure 
rainfall with the weather station. 
Plug it into the last remaining port 
on the weather station board, as 


O6 - POWER AND NETWORKING eee iaeineae! 


Now that the weather station is constructed, you can 


Rainwater is collected in the top 
é of the sensor, so that the amount 
the cables will reach both power and a router and of rainfall can be measured 


attach the final cables as shown in the diagram. The 
splitter cables can only go one way round, so there's 
no chance of getting it wrong! 


provide it power and networking; find a spot where 


The networking and power 
input are set up away from 
the Raspberry Pi 


@ The Ethernet cable lets you power the weather 
i station and give it network capabilities, thanks 
} to Power over Ethernet (PoE) 


SET UP THE 
SOFTWARE! 


Now it’s built, 
it's time to get 
the software 


1 
I 

| Only one cable is 

1 heeded to power the 

' Pi and connect it to the 
e@ outside world 


working. 
Follow the 
handy online 
guide here: 
magpi.cc/ 
1QZyYjt8 


74 | MagPi June 2016 raspberrypi.org/magpi 


Image from the Met Office 


ORACLE WEATHER STATION 


Analysis chart 
‘alid OOOO UTC Fri 13 MAY 2016 


993)0* 


FORECASTING 
THE WEATHER 


How exactly can the readings help figure out upcoming weather? 


ll of us at some point have 

seen a TV weather forecast, 

but what does it all 
mean? The BBC have an excellent 
video that helps to explain the 
terminology of weather forecasts, 
and how the forecasts are made in 
the first place, which you can see 
here: youtu.be/IITCF3UPVu4. 

As you can see from the video, 
the weather forecast is determined 
by high pressure, low pressure, 
isobars, and fronts. High pressure 
is generally associated with good 
weather, which is defined as the 
air getting heavier and denser, 
creating higher air pressure. The 
air dries under high pressure; this 
usually occurs in the summer. 

Low pressure is the opposite: the 
air rises and draws in water vapour 
which then creates clouds. Clouds 
mean rain, eventually, and clouds 
also block the sun, meaning its 
heating effect is slightly negated. 


Pressure maps for the weather 
are usually also represented with 
lines; these are the isobars and they 
determine the wind strength. If 
isobars are close together, it means 
strong winds; the further apart they 
are, the gentler the breeze is. 
Finally, fronts are the invisible 
lines that determine when two 
different masses of air meet 
together. The air can have different 
densities on each side, and be 
cooler or warmer. Fronts usually 
result in rain or storms, depending 
on their intensity. 


How to make 
predictions 
A weather forecast is a useful 
prediction of future conditions, 
but how are these predictions 
made? There are two key steps 
to predicting the weather. 

First is data collection. Vast 
quantities of data are collected 


about current conditions all over 
the world. This is done using 
satellites, ground-based observers, 
and weather stations like the kit 
you’re using. They gather data on 
temperature, pressure, wind speed, 
cloud movement, and other little 
bits of information. 

Once data is collected, it’s then 
modelled. This computer model, 
which knows the state of the 
weather at various points, then 
predicts the path of weather fronts 
and systems. These models are 
not always completely accurate, 
especially when you’ve decided to 
have a picnic or go to the beach. 
The further ahead in time the 
prediction is, the less reliable it 
becomes. However, prediction 
models are becoming ever more 
sophisticated and, with the help 
of your experiments using the 
weather station, may become 
more accurate still. 


Feature 


H here stands for 
high pressure, 
with the actual air 


Lon this map 
stands for low 
pressure, and you 


is lower than its 
high counterparts 


These are the 


how the pressure 
changes in the air 


(triangles), warm 
(semicircles), or 
occluded (mixed), 
and bring changes 
in the weather 


pressure in millibars 


can see that the air 
pressure in millibars 


isobars, which show 


The fronts are cold 
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MEASURING 
WIND SPEED 


Get started using the weather station by finding out the current wind speed 


et’s use the anemometer, 
or wind speed sensor, to 
collect data about wind 


speed. The sensor has three arms 
with buckets on the end which 
‘catch’ the wind, causing the arms 
to spin. If you were to dismantle 
the sensor, you would find a small 
magnet attached to the underside. 
At two points within the 
magnet’s rotation, it triggers a 
reed switch which produces a LOW 
signal we can detect. So, for each 
full rotation of the arms, the sensor 
will produce two detectable signals. 


Detecting the signal 
Before we begin calculating 
wind speed, we need to be able 
to count the signals coming 
from the anemometer. Set up 
your Raspberry Pi and ensure 
you are in desktop mode, then 
launch a terminal window. 

Create a weather station 
directory by typing mkdir 
weather_station and 
pressing ENTER. Once that’s 
done, open up Python by 
typing sudo idle3, and add 
the following code... 


#! /usr/bin/python3 
import RPi.GPIO as GPIO 


def spin(channel): 
global count 
count = count + 1 
print (count) 


GPIO. setmode(GPIO.BCM) 
GPIO.setup(pin, GPIO.IN, GPIO.PUD_UP) 
GPIO.add_event_detect( 

pin, GPIO.FALLING, callback=spin) 


input("Press enter to stop logging\n") 
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Now you can test your code! 
Press F5 and save when prompted. 
Your code should display the 
number of half-rotations counted. 
Press CTRL+C to stop the program. 

We can now count the signals 
from the anemometer; next, we 
need to calculate the wind speed. 


Calculating wind speed 
We can count the number of 
rotations of the sensor by doubling 
the detected inputs. But how do we 
change that into a speed figure? 
Let’s start by considering the 
formula for calculating speed: 


Speed = Distance / Time 


Imagine we counted the number 
of signals over the course of 5 
seconds. We now have the time, 
but we also need distance. The 
distance travelled by a cup will be 
equal to the number of revolutions 
multiplied by the distance 
around the edge of the circle 
(circumference). So we could write: 


Speed = Revolutions 
Circumference / Time 


The circumference can be 
calculated if we know either the 
radius or diameter of the circle. 
We can measure the radius of the 
circle made by the anemometer 
by measuring the distance from 
the centre to the edge. Knowing 
the radius, we can find the 
circumference with 2 x 1 x r. We 
also know that the revolutions 
are half the number of signals 
detected, so our formula becomes: 


Speed = (Signals/2) x (2 x 1 x r) 
/ Time 


This formula should enable us to 
calulate the speed of the wind in 
cm/s (centimetres per second). 


Updating the code 

Now that we’re able to calculate 
the wind speed from the 
information we can collect, 


we need to add the code to make 
this work. We need to measure the 
radius (in cm) of the anemometer 
for use in the program, and 
decide on the time interval for 
calculating average wind speed 
(at least 5 seconds). 

Add to the code using the 
listing (on the right) as a guide 
— or download it — and save it 
as windspeed. py. 


Measurement units 
Currently, the program we have 
created will measure the wind 
speed in cm per second. However, 
this isn’t particularly useful. A 
more practical unit would be km 
per hour. In order to convert our 
units, we’ll need to convert cm to 
km and convert the seconds into 
hours. Work out how many cms are 
in akm, and seconds in an hour, 
and change the code accordingly. 


Calibration 
The program should now display 
the wind speed in km/h, but 
is it accurate? The info for the 
anemometer says that if it rotates 
once a second, that should equate 
to 2.4 km/h. So, in the example 
interval of 5 seconds, 5 spins (10 
signals) should equal 2.4 km/h. 
Run your program and spin the 
anemometer 5 times within the 
first 5 seconds. What wind speed 
value is reported? You should see 
something like: 


WAN DU BWN PB 


10 
2.03575203953 kph 


That’s not quite right! This loss 
of accuracy is due to something 
called the anemometer factor, 
and is a result of some of the wind 
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windspeed.py Fatem 


>PYTHON 


#!/usr/bin/python3 


import RPi.GPIO as GPIO DOWNLOAD: 

import time, math magpi.cc/ 
aWuoKwK 

pin = 5 

count = 0 


def calculate_speed(r_cm, time_sec): 
global count 
circ_cm = (2 * math.pi) * r_cm 
rot = count / 2.0 
dist_km = (circ_cm * rot) / 100000.0 
# convert to kilometres 
km_per_sec = dist_km / time_sec 
km_per_hour = km_per_sec * 3600 
# convert to distance per hour 
return km_per_hour 


def spin(channel): 
global count 
count += 1 
print (count) 


GPIO.setmode(GPIO.BCM) 

GPIO.setup(pin, GPIO.IN, GPIO.PUD_UP) 
GPIO.add_event_detect(pin, GPIO.FALLING, 
callback=spin) 


interval = 5 


while True: 
count = @ 
time.sleep(interval) 
print (calculate_speed(9.0, interval), “kph") 


energy being lost in turning the : > 
arms. To compensate for this, we f { 
are going to have to multiply the = 
reading generated by our program L 
by a factor of 1.18, which should 
correct this error. Update the final = 
line in the calculate_speed 
function to read: Above The 
anemometer, 
or wind speed 
sensor, is a very 
simple device 


> 


return km_per_hour * 1.18 


Rerun the code and this time you 
should get a value closer to 2.4. 
If you’re having a bit of trouble 
getting the code right, download 
the complete version of it from 
here: magpi.cc/1WuolIVF. 
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FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


F.71.Q. 


YOUR QUESTIONS ANSWERED 


PI ZERO 1.3 


New cable 

The standard cable that comes with the Camera 
Module is too big for the connector on the Zero (the 
normal one couldn’t fit), so you’ ll need to replace it 
with a different one. They’re available online from 
places like the Pi Hut: magpi.cc/1V5Ngdh. 


Insert the cables 

The connectors on both the camera board and the Pi 
Zero open by pulling back a tab that secures the cable. 
Make sure the silver strip on the new ribbon is the 
same orientation as the old one on the board, secure 
it, and then connect it in the same way to the Pi Zero. 


Enable the camera 

Once the camera is connected up, turn on the Pi Zero. 
After it loads up the desktop, go to the Program menu 
and select Preferences>Raspberry Pi Configuration. In 
the Interfaces tab, you'll find an option to enable the 
Camera Module. Do this and then reboot. 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 


to feature in a future issue. 


ia 


Check the power 

Make sure you have enough power going to the Pi Zero, 
either by using an official Raspberry Pi power supply or 
checking the amps on your adaptor. If you have too much 
plugged in, it may not run well off a PC’s USB port. 


Manual SD card creation 

If NOOBS isn’t working, then you’ ll need to burn the 
SD card manually. Download the image for the latest 
Raspbian to your computer and then follow the guide 
to writing an SD card: magpi.cc/1V50j8E. 


New SD card 

Your SD card might be shot from too much use, so it 
may be worth getting a new one and then following 
the guide to write the image manually to the SD card. 
8GB cards are generally best for the Pi Zero, although 
you can use slightly larger cards. 


Taking photos 

The Pi camera on the Zero will work the same way it 
does on a normal Raspberry Pi. Once the camera is 
enabled, you can use raspistill in the terminal to 
start taking photos from the camera. You can read a full 
guide to how it works here: magpi.cc/1YuuUo3. 


Taking video 

Again, the raspivid command in the terminal will 
work in the same way. The Pi Zero being so slimline 
means you can make a great little camera for quick 
videos or a Go Pro-style experience. Read more about 
it here: magpi.cc/1V50DEy. 


Programming with Python 

With the correct libraries, you can program the 
camera with Python, which you can do slightly 
more easily through the terminal. We have a pretty 
thorough guide to doing different things with the 
camera in Python in issue 45 of The MagPi. 
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Does the Raspberry Pi support networking? Does the Raspberry Pi have built-in wireless networking? 


The Model B, Model B+, and Model 2B/3B versions Only the Pi 3 has built in wireless LAN, but all other models 
of the device have built in 10/100 wired Ethernet. can support a USB WiFi dongle. The Foundation offers its own 
There is no Ethernet on the Model A, Model A+, branded WiFi dongle which has been fully tested for use with 
and Zero versions. the Raspberry Pi. It is available through the Swag store. You 


can, of course, use a dongle from another provider if you wish. 


Does the Raspberry Pi support any form 


of netbooting or PXE? Why is there no Gigabit Ethernet? 
The Raspberry Pi does not support PXE booting or The Ethernet is attached via the USB 2.0 bus, so the 
network booting without an SD card. If you want to upstream bandwidth would not support Gigabit. 


network-boot multiple Raspberry Pis, you could use 


PiNet. This is a free and open-source community-based Does the Raspberry Pi have built-in Bluetooth? 
project initially designed for schools. Each Pi boots off a Only on the Raspberry Pi 3. 


small set of startup files on an SD card and fetches the 


rest of the data it needs from the PiNet server, thereby How do | connect more USB devices? 

allowing you to maintain a single operating system image | Use a USB hub to increase the number of ports. Some 

for all the Pis. PiNet also adds network user accounts, keyboards have USB hubs built in, which would work well. 
shared folders, and automated backups. It is highly recommended that you use a powered USB hub. 


Having trouble with The MagPi on the App Store or Google Play? 
Here are your most common questions answered: 


How do! find The MagPi on Google Play 

or the App Store? 

Allyou have to do is go to the search bar and type ‘The MagPi’ 
or ‘Raspberry Pi’ to find us. 


I've subscribed to the digital edition and | can't sign 

in to restore my purchases. Please help! 

Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 


your purchases on your current device, or make your purchases 


available on other devices, all you need to do is press ‘Subscribe’ 
on the home screen, then ‘Restore Purchases’ on the next screen. 


How can! search the digital magazine for keywords? 

Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app's GUI to show, and then 
press the small magnifying glass icon in the top-right corner of the 
screen. Just type in your search term to find the relevant results. 
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GET IT ON 


>» Google Play 


4 Available on the 


Ss App Store 
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Maker 
says 


A 


community- 


developed, 


Ubuntu-based 


operating 


system that 


beautifully 
integrates 
the MATE 


desktop 
Ubuntu 


RASPBIAN 
Raspbian is 
the officially 
supported 
operating 
system of the 
Raspberry 

Pi, and is the 
best all-round 
operating 
system for 
learning and 
general use. 


Free 
raspbian.org 
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UBUNTU MATE 


 vx:00222100 


ubuntu MATE 16% 


Choose an option to discover your new operating system. 


We Features 


</> Get involved 


BE shop 


ent rental nando 


8gF communty 


Dy che Room 


UBUNTU MATE 


Ubuntu 16.04 LTS runs really well on the Raspberry Pi 
using the lightweight MATE desktop environment 


ith its 1.2GHz processor, 
plus WiFi and Bluetooth, 
the Raspberry Pi3 has 
the chops to match some laptops. 
This speed boost has thrown 
new light on alternatives to 
Raspbian, the officially supported 
operating system. 
On Intel-based desktops, Ubuntu 
is one of the biggest names in 
Linux. Canonical, the maker of 
Ubuntu, has just released version 
16.04 LTS of the Ubuntu operating 
system. Surely this would bea 
splendid time to get Ubuntu on the 
Raspberry Pi? 

This is where Ubuntu MATE 
steps in. Ubuntu MATE isn’t quite 
the full edition of Ubuntu: it swaps 
out the Unity desktop interface for 
a lighter version known as ‘MATE’. 
Ubuntu MATE for the Raspberry 
Pi was developed by Martin 
Wimpress and Rohith Madhavan, 
and it intersects nicely with the 
recently released Raspberry Pi 3. 
Ubuntu MATE is built on the 
brand new 16.04 LTS edition, but 


with an older and less demanding 
interface. Sounds perfect, right? 
We found the installation to 
be a relative breeze, although a 
16GB microSD card was required 
(the instructions hint that you 
might want to use one). When you 
start up Ubuntu MATE, a welcome 
screen offers specific Raspberry Pi 
information. Here you can resize 
the file system to use the full space 
on the SD card (rather than the 
default 3.9GB image size). 


A familiar MATE 

MATE is a slicker interface than 
LXDE (the desktop included with 
Raspbian). While the two are 
functionally similar in many ways, 
MATE has rounded windows and 
more colourful buttons. It’s also 
vastly more customisable, witha 
range of preferences to change how 
it looks and works. A MATE Tweak 
setting enables you to determine 
the appearance and included 
elements for the desktop, interface, 
and windows. 


Ubuntu MATE comes packaged 
with a comprehensive set of 
default programs. Caja is the 
default file management app, 
which is on a par with PCMan, 
although not as feature-rich 
as Nautilus (included with the 
desktop version of Ubuntu). 
Pluma is the default text editor; 
again, we find this slightly 
more stylish than LeafPad, 
although both are basic as 
regards functionality. 

Beyond this, you get the 
LibreOffice suite and Firefox 
web browser. Programming is 
covered with Scratch, IDLE, and 
Sonic Pi. One area where it excels 
is multimedia, with big-name 
apps like Rhythmbox, VLC media 
player, and Shotwell working out 
of the box. 

Although you get access to the 
Ubuntu repository in Ubuntu 
MATE, you don’t get access to the 
Raspbian repository by default 
(and so we needed to add it from 
magpi.cc/24IM2D8). 
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It’s a good idea to manage your 
expectations on software. You 
still only get access to AArch32 
(ARMv7) software, not Intel 
i86 packages. Programs like 
VirtualBox, Minecraft Java, and 
Adobe Flash remain out of reach. 

While Ubuntu has a lot of 
consumer software, Raspbian has 
better programming tools in the 
box: Blue J Java, Node-RED, and 
a free version of Mathematica 
software that costs £190 on other 
Linux operating systems). 


An educational 0S 
Raspbian remains a much better 
choice for learning the nuts and 
bolts of programming, thanks to 
its wider range of coding programs. 
This is also because Raspbian 
features in so many tutorials, while 
Ubuntu MATE leaves you to figure 
things out. 

It’s not a complete loss. Ubuntu 
MATE comes with RPI.GPIO and 
gpiozero installed, and we found it 
just as easy to get an LED blinking 
in Ubuntu as Raspbian. 

Even so, with most tutorials 
aimed at Raspbian users, you’d be 
better off sticking with the official 
distro for education and learning. 

We put both Raspbian and 
Ubuntu MATE through a series of 
speed tests to determine which has 
the edge for performance. 
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Our first test was a stopwatch 
for startup (from the time the 
power was connected to the point 
you can click and get a response 
from the menu). We disabled 
the welcome screen on Ubuntu 
MATE and turned on automatic 
login. Ubuntu MATE started up 
in 39.59 seconds while Raspbian 
was ready in 20.91 (almost twice 
as fast). 

The slower performance 
extended to opening apps. 
LibreOffice took 9.18 seconds 
to start in Raspbian, and 16.25 
seconds in MATE. 

We installed HardInfo on both 
operating systems and ran a series 
of system benchmarks with the 
winners in bold: 


> CPU BLOWFISH (HIGHER BETTER) 
43.70 - Raspbian 
40.87 - Ubuntu MATE 

> CPU CRYPTOHASH (HIGHER BETTER) 
24.63 - Raspbian 
24.94 - Ubuntu MATE 

> CPU FIBONACCI (LOWER BETTER) 
13.47 - Raspbian 
14.03 - Ubuntu MATE 

> FPU FFT (HIGHER BETTER) 
48.73 - Raspbian 
47.95 - Ubuntu MATE 

> FPU RAYTRACING (LOWER BETTER) 
43.89 - Raspbian 
54.25 - Ubuntu MATE 
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Left Firefox is the web browser of choice for Ubuntu MATE 
Above Get great system monitoring tools through the OS 


Raspbian was faster in every test 
apart from CPU CryptoHash, where 
having a higher score is better (and 
the 0.3-second difference seems 
negligible to us). 

Having said that, Ubuntu 
MATE is perfectly usable on the 
Raspberry Pi, and we had no 
problem running multiple apps 
and programs. If your focus is to 
run a Raspberry Pias a regular 
computer, then Ubuntu MATE has 
a lot to offer over Raspbian. 


{ast word 


While Raspbian remains 

a better choice for project 
building and education, we 
have oodles of admiration 


for this fully rounded 
desktop operating system 
running on the Raspberry 
Pi 3 microcomputer. 


Above The 
presentation is 
very much like a 
standard Linux/ 
Ubuntu release 
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Maker 
says 


Makes it 
easy to move 
your messy 
Raspberry Pi 
breadboard 
projects to 
a PCB 


ProtoBoards.co.uk 


PROTOPAL 


Possibly a better 
choice for larger 
Pi models, 

it features a 
larger 288-hole 
prototyping area 
and two (user- 
connected) 
power rails 


PROTOZERO 


An easy-to-use prototyping board with perfect Pi Zero proportions 


readboards are great for 

testing out electronics 

projects, but the end 
result may well look messy, often 
featuring a spaghetti-like tangle 
of jumper wires. Not only that, but 
such a setup isn’t all that portable, 
as some loose wires or resistors 
could easily fall out if you dare to 
move it. If you’re looking to make 
your project more permanent and 
practical, you’ ll want to solder the 
components to a prototyping board 
like this one. 

The subject of a successful 
KickStarter campaign, the ProtoZero 
is the brainchild or Richard 
Saville, author of the popular 
averagemanvsraspberrypi.com 
blog. Resembling the little brother 
of his previous ProtoPal prototyping 
board, it’s made of perfboard and is 


=~ designed to match the dimensions 


£5/$7 
magpi.cc/1TzsZ69 
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> _of the Pi Zero perfectly, although it 


can also be used on any other 40-pin 
model, including the Pi 3, 2, A+, and 
B+. While it is can not technically 

be described as a HAT, as it lacks 


an EEPROM, the ProtoZero does sit 
neatly on top of the Pi’s GPIO pins, 
for which it has two corresponding 
rows of connector holes with helpful 
abels. The remaining 154 holes — 
ikewise featuring high-quality ENIG 
electroless nickel immersion gold) 
PCB plating — are arranged in printed 
anes of three or four. Components 
may be soldered to the front or 
similarly labelled) rear, if you want 
to hide unsightly wires and suchlike. 
Example project ideas include an 
LED array, temperature monitor, and 
four-character digital display, but 
the only limit is your imagination. 
Note that since the ProtoZero 
comes in kit form, you’ll first need 
to solder the supplied 40-pin GPIO 
header to the board, but this is no 
more difficult than doing so for 
the Pi Zero itself - and you’ll be 
soldering components to it anyhow. 
One advantage, as well as reduced 
cost, is that you may elect to use 
a stacking header (not supplied) 
instead, enabling you to stack 
multiple ProtoZeros and/or HATs. 


While some veteran electronics 
project makers may prefer 
to create their own custom- 
made prototyping boards from 
inexpensive perfboard, the 
ProtoZero is ideal for less- 
experienced users who want to take 
their projects one step up from 
the breadboard. With its perfectly 
rounded edges and matching form 
factor, it also gives a professional 
look to Pi Zero projects. 


{ast word 


The ProtoZero offers 
electronics dabblers an easy, 
inexpensive way to make their 
projects more permanent, 
while neatly matching the 
dimensions of the Pi Zero for 


a polished finish. Using high- 
quality PCB plating, it features 
a labelled breakout of the 40 
GPIO pins, along with a decent- 
size prototyping area. 
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PICON 
ZERO 


Amuch more 
compact version 
of the RoboHAT, 
designed for 
the Pi Zero, 
although it can 
also be used 

ona standard 
Raspberry Pi. 


£13 / $19 
magpi.cc/1p9wGaA 


raspberrypi.org/magpi 


£20 /$29 


Maker 
days 


Complete 
robotics 
controller for 
Raspberry Pi 


Atronix 


ROBOHAT 


A full-sized Raspberry Pi robotics controller and the bigger sibling 
of the Picon Zero. Should this be your controller of choice? 


nother month, another 

robot board for your 

Raspberry Pi; this time 
we’re looking at the RoboHAT from 
4tronix, basically a bigger version 
of the Picon Zero we looked at last 
issue. This board is designed to 
work with all 40-pin Raspberry Pis 
(so no original Model A or B, sadly) 
and as it’s a HAT, it attaches neatly 
on top of acompatible Raspberry Pi 
without hanging off the sides. 

Like the Picon Zero, the 
RoboHAT comes with an amazing 
number of inputs, outputs, and 
general robot connections to 
make use of. It all comes pre- 
soldered on a very sturdy piece 
of PCB, so you’re ready to start 
using it right away. On the board 
are the requisite DC motor screw 
terminals; the ROboHAT comes 
with two, enabling it to control two 
motors. There’s a set of pins for 


connecting the popular HC-SRo4 
ultrasonic distance sensor, anda 
mixture of ten input and output 
pins, along with a series of I?C 
breakout pins. It’s powered by a DC 
jack that can also handily power 
the Raspberry Pi while in use, 
cutting down on power inputs. 

It’s all more spread out than 
on the Picon Zero, so the board 
becomes a bit less of a mess when 
everything is connected up and in 
use. There are also custom Python 
scripts and libraries to get it all 
working, making programming 
very easy. For example, importing 
the robohat module allows for 
robohat.forward() to move the 
robot forward. There are many 
examples included to get your head 
around how the library works, and 
they’re all very easily installed 
using the instructions on the 
4tronix blog: magpi.cc/1TPBtWJ. 


t’s a good board for novices and 
also some advanced users, allowing 
you to take the skills you may have 
learnt from a very simple kit and 
apply them to a custom project of 
your own design quite easily. It’s 
easy to find out which GPIO pin 
controls which aspect, so you can 
create further custom code if that’s 
your thing, making it fairly open 
and versatile. It’s also a pretty 
good price at only £20. 


{ast word 


Awell-designed robot HAT 
that works very well with 
the Raspberry Pi and many 


common robotics components. 
Definitely worth a look if you're 
planning to advance your 
Raspberry Pi robotics. 
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Turn your 
Raspberry 
Pi into a 
modern 
indoor air 
quality 
monitoring 


device 
LiV Pi 


RASPBERRY 
Pl ORACLE 
WEATHER 
STATION 


It's not quite the 
same, but you 
can measure 

the weather with 
the Raspberry Pi 
Oracle Weather 
Station, albeit 
without precise 
pollution sensors. 


magpi.cc/1Va4d23 
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A powerful air quality monitor made for the modern and slightly 
polluted world, powered by Raspberry Pi 


oming from Hong Kong, 

the LiV Pi is a curious, 

Raspberry Pi-compatible 
product. Marketed somewhat as 
a device for businesses to keep an 
eye on the air quality inside their 
uildings, it’s a product that’s 
een created mainly to suit the 
situation in Hong Kong. The city 
has some serious air pollution 
problems, which you can read more 
about elsewhere. So, with that and 
general building safety in mind, it 
does start to make more sense. 

What the LiV Pi boils down to 

is a large, colourful acrylic case 
with a two-line LCD display on the 
front. Inside, you’re supposed to 
install a Raspberry Pi along with 
the specially provided add-on 
board that functions almost like a 


b 
b 


HAT. This HAT allows you to plug 
in some supplied sensors anda 
real-time clock, and then you’re 
basically ready to go. 

LiV Pi ships with three main 
sensors: a carbon dioxide (CO,) 
sensor, a temperature/humidity 
sensor, and an air pressure 
sensor. The CO, sensor is the main 
component here, and the LiV Pi 
team explain on their website that 
a rise in CO, levels in the airisa 
good indication of air quality, since 
it’s likely to have bought much 
nastier air with it. The humidity 
and temperature sensor allows you 
to keep track of the environment 
indoors in other ways, and it 
sounds like the barometric 
pressure sensor was thrown into 


the system just because they could. 


There’s some fun to be had 
constructing the full LiV Pi. On the 
website, you can buy a bare-bones 
kit of the sensors and board (pre- 
soldered or not). Alternatively, 
you can get the full version with a 
case, which is what we’re looking 
at here. The price does seem quite 
steep; $350 for the full LiV Pi is 
not an easy number to swallow, 
although it’s not ‘targeted’ 
towards consumers per se. 

The construction is quite simple. 
With the full kit you get the acrylic 
case, which almost snaps together 
and is made up of six pieces. The 
snapping isn’t very firm, so there 
are screws and spacers to keep it 
together, making it fairly easy to 
assemble and disassemble when 
needed. This version also comes 
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with everything already soldered up 
on the boards. Then again, there’s 
not a huge amount of soldering to 
be done with the basic kit version 
(from $35): the odd resistor and 
connector is all that’s required, 
with the trickiest bit being the 
40-pin connector for the GPIO. 
Once the case is together, it’s just 
a matter of plugging the sensors into 
the correct ports, putting a battery in 
the RTC, and hooking it up to the LCD 
screen. The guides online and the 
markings on the boards show more 
than enough to do this accurately. 
Finally, you’ll need to install an SD 
card with the custom LiV Pi image 
before packing it all in the case. 
With the full pre-soldered kit this 
is all quite quick; in fact, writing 
the SD card will take longer than 
constructing the rest, so you should 
probably get that started beforehand. 
The software requires a bit 
of setup to get working at ful 
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capacity. You need to make sure 

it has a network connection and 
that the hardware clock is working, 
and you can also set up email and 
other message alerts. This does 
allow you to keep the LiV Pi in its 
box most of the time, though; you 
can dial in with a browser to view 
data and get email updates about 
the current readings instead of 
manually plugging it back into 

a monitor. The whole system is 
pretty complete and is continually 
getting updates; at the time of 
writing, they had recently added 
Raspberry Pi 3 support and have 
even begun selling the full kit with 
a Pi3. So, for the moment, it’s well 
supported and with upgrades to 
come in the future. 

However good it is, with decent 
sensors and good software to keep 
an eye on them, we do wonder how 
useful a device this will be. We 
can definitely report that it does 


There's plenty 
of space inside the 
case for the Pi, and 
there are some 
easy-access points 
for specific ports 
as well 


— | 


The 
full range of 
components is not 
very high when 
it comes ina full 
kit, and they’re all 
quick to assemble 


what it sets out to do: it monitors 
the air, and it does it well. If this 

is something you or a business 
have been looking for, then it’s 
definitely worth a look due to its 
extra network connectivity and 
customisation over other solutions. 


It has very limited uses and is quite expensive, but 
the design is good and it does what it sets out to 
do very well. Building it is pretty fun, too. 


Kkkk 
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PROGRAM ut should keep you motivate 
RA S P B E RRY PI ARCADE GAMES, oo the ue. ong the 
BE ST SE LLE R S al an <a aos searching 


and sorting, to sprites 
and array-backed 
grids will be gradually 
absorbed, until the reader 
has the skills to write their 
own games. 
There is plenty of code 
in this book - more than 
we’d normally expect 


A new generation of C tutorials for 


aq new generation of programmers Author: Dr Paul Vincent Craven 
Publisher: Apress 


LEARNC SBN: o7eaaean7ic 
THE HARD 
WAY 


Based on 
Craven’s popular 


programarcadegames.com to see — but Apress’s 
Author Zed shaw website, and now in its fourth production is excellent here, with 
Publisher: Addison Wesley dic hisieniea Baek feats, Ween a A 
price £24.05 e ition, this boo oes a superb jo pages 00 ing we alanced, an 
ISBN: 978-0321884923 of fitting programming concepts- beginners unlikely to be unnerved 
magpi.cc/1TQkpD1 and Python learning — to building by the sight of so much Python! 
several games with the ever useful _—_ Plentiful exercises, including a 
Pygame library. Programming whole chapter at the end revisiting 
Zed shaw famous typejall lessons are carefully introduced every project in the book, drive 
of this in yourself method of , 
instilling learning, brought to throughout each game or game- the lessons deep. Well written, 
C. Strongly opinionated but, if related project — starting with well developed, and — despite 
youlget oniwith it a/practical type correctness in the opening eschewing the self-conscious 
introduction to C basics. ; ‘ 
calculator example. whimsy of some other tutorials — 
Aimed at younger readers, but very enjoyable to work through. 


accessible to all, Craven’s teaching 

experience shows through in 

both tone and pace: this is a book score 
that you will not finish quickly, 


EXPLORING THE interface, and pipwm, for handling 
RASPBERRY PI 2? PWM (pulse-width modulation) 
WITH C++ signals. The powerful pispy 


captures GPIO data and in 
the book is used to build an 
oscilloscope. Practical electronics 


LEARN TO 
PROGRAM 
WITH C 


Authors: Noel Kalicharan 
Publisher: Apress 

Price: £17.50 

ISBN: 978-1484213728 
magpi.cc/1TQkJBu 


Author: Warren Gay 


Acomprehensive C tutorial for Publisher Apress 


non-programmers that - despite an feature in circuit designs for 
missing appendices on setting Price: £29.99 . . : 8 

up a compiler - wins friends ISBN: 978-1484217382 debouncing input signals. 
through the excellent clarity of magpi.cc/1TQkeaS A C++ primer feels slightly 


the author's explanations. misplaced three quarters of the 


C++ is a powerful way in, but you can skip forward 


PRO G RAM M | N G | N C, and complex beast, which does to that point at any time. Lastly, 


; little to protect you from your a multicore web server highlights 
4TH ED ITI 0 N — = mistakes, and is not something the Pi 2’s abilities, then leaves 
‘ we often see in a Pi project. the challenge of improving and 
Authors: Stephene) Kochan Nevertheless, if you’ve learnt the finishing the project to the reader. 
Publisher: Addison Wesley ‘i : ; ; 
price 0c basics, you can build your skills Appendices on GPIO classes, and 
ISBN: 978-0321776419 while experimenting with your other classes — such as Matrix, 
magpi.cc/1TQkIxs favourite single-board computer, which document those used earlier 
thanks to this interesting tour in the book — round off a book 
, ; of the Pi, its hardware, and some which may be essential, if you 
Comprehensive, a classic (now faa: 
onits fourth edition), and very useful C++ programs. want to work on your Pi with C++. 


detailed: serious but readable. Download the code from 
If you struggle with pointers, 


; ‘ 
this could be the book to give magpi.cc/ TIQROy? and yOu S core 
you that ‘aha’ moment. get useful utilities like gp, which 
manipulates and reads the GPIO 
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LEARNING PYTHON 
DESIGN PATTERNS 


Author: Chetan Giridhar 
Publisher: Packt 

Price: £25.99 

ISBN: 978-1785888038 Kot 
magpi.cc/1TQkVRj : 


Learning Python 
Design Patterns 


Second Eaition 


When Kent Beck and 

Ward Cunningham 

began applying the concept of 

design patterns, espoused by 

architect Christopher Alexander, 

to programming, OOP (object- 

oriented programming) was stilla 

relatively tiny niche. As it grew over 

the next decade, design pattern 

use spread, and basic patterns 

were collected in the famous 

Gang of Four book. These proven 

development paradigms speed up 

programming, and well-defined 

components and interfaces make 

for scalable and maintainable code. 
With many of today’s 

intermediate Python programmers 

not coming from a formal Java 

or C++ background — and many 


INTRODUCING GO: 
BUILD RELIABLE, 
SCALABLE PROGRAMS 


1 rassemeee 


Author: Caleb Doxsey 
Publisher: O'Reilly 
Price: £16.50 

ISBN: 978-1491941959 
magpi.cc/1TQkZkg 


Introducing 


Gor. 


Go may bea 
difficult word to 
Google for, but 
the language has many positives — 
bringing 40 years of advances toa 
C-style language, from concurrency 
to memory safety. The key feature 

is simplicity, even at the cost of 
missing out on features taken for 
granted in other languages. 

To match the Go language’s 
simplicity, this is a concise, efficient 
introduction to a concise and 
efficient language, and very much 
in the tradition of K&R. Indeed, 
you’ ll find yourself taking that 
classic off your shelf to check half- 
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Caleb Oensey 


patterns being workaraounds 
for the limitations of those two 
languages — what’s needed 
is an introduction from 
the perspective of dynamic 
scripting languages like 
Python. Giridhar provides 
this with a practical, 
Python-based look at several 
well-known patterns, from 
Observer to MVC patterns. 
Following a useful 
introduction to OOP concepts and 
design patterns, we start with the 
Singleton design pattern, then 
progress through several patterns — 
all with Python code, and practical 
examples, as well as a discussion 
weighing up the advantages and 
disadvantages. Lastly, AntiPatterns 
tells the reader “what we shouldn’t 
do as architects or software 
engineers.” Concise, thoughtful, 
and a useful stepping stone on your 
Python journey. 


Score 


remembered references as you spot 
them in Doxsey’s Go introduction. 
Types, variables, and control 
structures make for a gentle start, 
with the opening chapters 
accessible for relatively 
inexperienced programmers. 
Exercises at the end of each 
chapter ensure that the 
reader thinks through each 
topic covered. 
‘Arrays, Slices, and Maps’ 
— we were very pleased to 
see an Oxford comma in the 
chapter title — and ‘Functions’ 
manage to cram a lot of idiomatic 
Go into explanations which, like the 
language, know what to leave out. 
Concentration is required for the 
pared-back coverage of further Go 
features, then chapters on packages, 
testing, and concurrency leave the 
reader well prepared to tackle some 
real-world challenges in Go. 


Score 


ESSENTIAL READING: 
DJANGO 


The Django web framework is the comprehensive, 
and Pythonic, answer to your website needs 


Django Girls Tutorial . 


Author: Django Girls 
Publisher: Online tutorial 
Price: Free 

ISBN: N/A 
magpi.cc/1WptxT1 


From total beginner to fully working 


Beginning Django CMS 
Author: Nigel George 

Publisher: Apress 

Price: £22.99 

ISBN: 978-1484216705 
magpi.cc/1WptBlT 


George assumes no Django 
knowledge, and gets you up and 
running - a welcome alternative to 
the occasionally opaque official docs. 


blog site with Django - an online version ———————— 


of the Django Girls workshop. 


Django By Example 


Author: Antonio Melé 
Publisher: Packt 
Price: £28.99 

ISBN: 978-1784391911 
magpi.cc/1WptlOn 


Useful collection of real-world websites, 
from social sites to online shops. Good 
integration of other technologies. 


Two Scoops of Django 


Author: Daniel Roy Greenfeld 


& Audrey Roy Greenfeld 
i SEOORS OF: 
Publisher: Two Scoops Press DJANGO 
Price: £31.12 
ISBN: 978-0981467344 EST PRACT a 


magpi.cc/1WptMho 


High-level, low-level, practical, 
philosophical, opinionated, essential - 
a reference that makes “Python and 
Django as fun as ice cream.” 


High Performance Django 


Author: Peter Baumgartner 
& Yann Malet 

Publisher: CreateSpace 

Price: £28.23 

ISBN: 978-1508748120 

magpi.cc/1WptNl3 


“A repeatable blueprint for building and 
deploying fast, scalable Django sites” 
with lessons beyond Django sites. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


~ 


= 


nearly 2015, the Raspberry Pi Foundation set up a 

new programme called the Raspberry Pi Creative 

Technologists (rpct.io). Nine young creative 
people between the ages of 16 and 21 were put through a 
year-long programme of activities, to help them enhance 
their current creative projects through technology such 
as the Raspberry Pi. After a year of studying and making, 
it was finally time for the Creative Technologists to show 

settee off what they’d learnt at a special exhibition put on at 
agesture control Raspberry Pi HQ in Cambridge during April. With such 


eee projects as ‘Who is Terror’ (youtu.be/w3VA7nCgorl) and 


alight that moves _ an interactive pop-up book, there were plenty of amazing The ‘blinkenlights' project from Andrew Mulholland 
with your fingers. It's hi i ‘biti If abl k creates beautiful illuminated pictures with LEDs and overlays 
more complicated iMeS ts-— at oe ey OU au) : commie This interactive pop-up book by Maddy Pendergast almost 
thanitsounds! it, we’ve put together a little gallery for you to enjoy. stole the show, with the book projected onto paper to make the effect 
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THIS MONTH IN Pl 


Community 


SO00 snirrep 


The Raspberry Pi crowdfunded 
computer is currently making 
its first shipment to backers 


t’s been a busy 18 months for the pi-top crew. 
| No sooner had they launched their long-awaited 
pi-top Raspberry Pi laptop than they began 
crowdfunding a new project: the pi-topCEED, a $99 
Raspberry Pi desktop computer. Coming as a kit with 
a screen and Pi-powered innards, it’s a stripped back 
version of the original pi-top that came out at the end 
of last year, allowing the price to be reduced to hit that 
attractive sub-S100 mark. 

Things have progressed fairly well with the project, with 
only a slight delay to the original delivery date of April. 
That’s pretty good for a crowdfunded project, and the 
delay was to accommodate an upgraded screen anyway. 
The pi-topCEEDs are now finally making their way to 
backers as 5,000 are shipped out around the world. 

We’ve been keeping an eye on what the pi-top team 
get up to for a while now, due to their inventive view of a 
highly customisable, upgradable Raspberry Pi computer 
that’s ideal for learning programming and physical 
computing. Hopefully, the backers are happy with the 
final product and many kids and adults will get to learn 
some useful computing skills. 


GEED UNI Eivole 


The educational game from the folks at CEED is a very 
retro-looking open-world puzzle game that requires 
you to do actual coding to survive. It can also interact 
with physical computing, so you can create and learn 
about circuits as you play. All of your progress is saved 
to the cloud, so you can continue wherever you have 
access to the game. It’s still in active development, 
but it has come on in leaps and bounds since we first 
covered it in issue 40 of the magazine. 
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BEST OF THE REST 


SIMPSONS SHUFFLER 


as 
magpi.cc/1TpeBBB |) ti 
— 


hE 


INSTANT PI CAMERA 


magpi.cc/1quGXil 


June 2016 MagPi | 89 


ware sea, G) "ano mones 


ww 


6 


ep ISTE RASPBERRY PI JAM 


¥: 
& 
“6 
. 


RASPBERRY \\ 


Want to add your get-together? List it here: 


raspberrypi.org/jam/add 


RASPBERRY JAM LEEDS PI AND MORE 9 RASPBERRY JAM HULL 
When: Wednesday 8 June When: Saturday 11 June When: Saturday 25 June 
Where: Swallow Hill Community Where: Universitat Trier, Trier, Where: Malet Lambert School, 
College, Leeds, UK Germany Hull, Uk 
magpi.cc/10vi5gl magpi.cc/1TcyAp4 magpi.cc/1TcyH3X 
The aim of this Raspberry Jam At Pi and More, beginners At the Hull Jam, you’ll be able to 
event is to bring people together and experts meet for talks, get hands-on with digital making 
from across a wide area, to discover workshops, and projects activities, through workshops and 
the exciting potential of the Pi. focusing on the Raspberry Pi. a hackspace area to share projects. 
STAFFORD RASPBERRY JAM RASPBERRY JAM: 1ST WIMBLEDON 
When: Wednesday 8 June SLICE OF PI CLUB RASPBERRY JAM 
Where: King Edward VI High When: Tuesday 21 June When: Sunday 26 June 
School, Stafford, UK Where: Heart of Worcestershire Where: Wimbledon Library, 
magpi.cc/1TcysWv College, Redditch, UK Wimbledon, UK 
A big meetup where Pi magpi.cc/1TcyCo3 magpi.cc/10viCPj 


enthusiasts get together, share 
ideas, help each other, and most 
of all have fun! 


Spring season of the Slice of Pi Club 
where people show off projects, 
learn skills, and make robots. 


For people interested in making, 
creating, programming, electronics, 
robots, and computing in education. 
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oe RASPBERRY JAM 
> -e ° PRESTON 


a oF RASPBERRY JAM: 
Ss 2. SLICE OF PI CLUB 


ISTE RASPBERRY PI JAM 
When: Monday 27 June 
Where: Colorado Convention Center, 
Denver, 
CO, USA 
magpi.cc/10vijul 
This open session will allow people 
7 to learn all about the Pi from 
Raspberry Pi Certified Educators. 


RASPBERRY JAM PRESTON 

When: Monday 4 July 

Where: Media Factory Building, 
Preston, UK 

magpi.cc/10viZcF 

Join the Preston Pi community as they 

learn, create, and share the potential 

of the Raspberry Pi computer at an 

open, family-friendly event. 


raspberrypi.org/magpi 


@ RASPBERRY JAMLEEDS \ [ee a ~ 


KR” 
Gg RASPBERRY JAM HULL 
STAFFORD 
RASPBERRY JAM 
1ST WIMBLEDON 
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DONT MISS: 


When: Monday 27 June Where: Colorado Convention Center, Denver, CO, USA 


Held during the four-day =" f ) 

ISTE technology conference, — 

this will still act like a : S Beas: 

normal Jam, albeit ina ys 

much larger space. That ‘<A ; i 

means you can come and in 

show off your project, and 7 

also watch demos and of vs 
presentations on how to 

use the Raspberry Pi to 

its full potential. For more os "| 

details, check out the event = es | 


page: magpi.cc/10viJul 
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Witha 
slightly higher 
resolution and 
a NolR version, 

motion activation 
can be optimised 
further with the 
new camera 
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Subscription gift 

The new camera connector on the Raspberry Pi 
Zero is brill. It was actually something I’d been 
really wanting on there! I have a question, though: 
I don’t have a subscription, but I’ve been thinking 
of picking one up. I know you get a Raspberry Pi 
Zero with a subscription — has this been changed to 
one of the new Raspberry Pi Zeros with the camera 
connector? Will it also come with the cable adapter? 
It would probably persuade me to get one! 

James Daid 


As of this issue, any new subscriptions can get a 
bundle with a new Pi Zero with the camera port, 

the cable bundle we previously gave out to adapt 

the micro USB and mini HDMI ports, and the camera 
cable! The only downside is you won’t be getting 
issue 40 with it, although it’s still available as a 

free PDF download from our website. You can get 
this with 6- and 12-month subscriptions, and you 
can find out about them at magpi.cc/Subs1 


Camera compatibility 

There’s both a new camera and a new Raspberry Pi 
Zero out, so I was wondering what the compatibility 
between the two was? Does the original camera 
work with the Pi Zero? Is it a different cable 


for either camera? 
Roy T 


It’s somewhat of a coincidence with the timing of the 
two releases; however, you should be pleased to know 
that all versions of the Pi Camera Module (NoIR or 
normal, original or version 2) work on the Raspberry 
Pi Zero. Not only that, but the new cable works on all 
versions as well; you’1l need that cable to plug it into 
the Pi Zero, though. We’ve already seen some people 
upgrade the camera on their main Piand use the old 
camera on their new Pi Zero. 
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All the existing 
cameras work 
with the new 
Raspberry Pi 
Zero, as long 
as you have the 
adapter cable 


raspberrypi.org/magpi 


O 0) 


FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 


community - join in via raspberrypi.org/forums 


s anew boy of 88 years of age, who is endeavouring to 
repel the onslaught of galloping senility by swotting 
up on the Raspberry Pi, may I ask for some advice on 
which back issues would help me in my attempt at absorbing 
the necessary knowledge to move forward? 
atemunro 


Well, we have a few issues and books that have a beginner’s 
slant in some way. This very issue, in fact, has the beginner’s 
guide to electronics. Other issues that may interest you are 
issue 36 with our Getting Started with Raspberry Pi feature, 
our Pi Zero issue (issue 40) which will introduce you to the Pi 
Zero, and the camera issue from last month. All our Essentials 
books also start very simple and get more advanced, to teach 
you along the way, and there’s bound to be something to pique 
your interest in the Official Raspberry Pi Projects Book. They’re all 
available for free on our website: magpi.cc 
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Competition closes 27 June 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 


their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WoRD 


uite a few years ago, I once lined up early in 
the morning to buy a new smartphone on 
the day of its release. I’m not proud of that. 
In fact, I find myself cringing just thinking about 

it. At the time, I was closely following all the latest 
developments in technology and I had a severe case 
of consumer technolust. I almost always had to own 
the latest and greatest gadget, even if my wallet 
couldn’t quite accommodate my acquisitions. In the 
years that followed, I’ve cooled off quite a bit. I only 
rarely find myself pining for new consumer tech. 

Don’t get me wrong, | love all of the amazing 
advancements in consumer technology such 
as phones, tablets, laptops, wearables, and VR 
headsets. I don’t take for granted how far we’ve 
come in the last few years. For example, whenever 
I pull out my phone to search a map or send a photo 
to my friends, I think how lucky we are to have such 
powerful tools at our disposal. What’s changed is 
my interest in technology. I became more excited 
about how maker technology like Raspberry Pi can 
empower people to create the things they want 
instead of waiting for a large electronics company 
to make it for them. 

As an example, lately ve seen a lot of makers 
using Raspberry Pis to create ‘magic mirrors’, 
which are mirrors that can display information. 
These devices let you see news headlines as you 
primp in the morning. To create them, makers use 
a two-way mirror and mount a display behind it. 
The display is driven by a Raspberry Pi to show traffic 
conditions, weather, your agenda, the news, or 
anything else that you want. 

It’s quite possible that one day you’1l be able to 
find mass-produced consumer magic mirrors on 
retail store shelves. But maker technology like 
Raspberry Pi enables people to create it now instead 
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of waiting for large electronics companies to make 
one for them. While they may not be easy enough 
for a complete novice to set up, maker-made magic 
mirrors also have the benefit of being incredibly 
customisable and versatile. And instead of becoming 
completely obsolete, the parts can be repurposed 
for other projects when the time comes. 


Custom-made technology 

Pve been finding many other examples of makers 
using Raspberry Pis to create the products that large 
companies don’t yet make widely available. Makers 
with diabetes have used technology to create their 
own closed-loop systems between their glucometer 
and their insulin pump in order to micromanage 
their blood glucose levels. Another maker recently 
used a pair of Raspberry Pi cameras on a robot to 
create a remote telepresence vehicle for virtual 
reality headsets. 

Instead of consumer products, my technolust is 
for now for maker products, but I don’t feel the same 
kind of guilt. Maker technology is versatile and can 
be used for so many more things than could even be 
imagined by the products’ creators. And since maker 
products can be used for so many possible things, 
they have a much longer shelf life. Even though 
we’ve made so many improvements to the Raspberry 
Pi in the last four years, there are still many original 
Raspberry Pi Model Bs out in the world earning their 
keep, and I suspect that they’ll be chugging away for 
years to come. 

Although consumer technology is empowering, I 
think there’s one key thing about maker technology 
like Raspberry Pi that’s worth getting really excited 
about: what people create with maker technology 
today will become the consumer technology 
of tomorrow. 
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SL Components 


WE’VE GOT CASES FOR YOUR 
EVERY RASPBERRY PI NEED! yr 


e Standard Raspberry Pi Case 
e MEDIAPI+ 


e LCD Control cases 


© Spi-Box 
SB Components also manufactures cases for: 


ARDUINO BEAGLEBONE 


Oo [a] shop.sb-components.co.uk Call: 0203 514 0914 


At SB Components we sitive to offer our customers the best prices for the best products. 


crak Our product team works tirelessly fo source top quality affordable components from around the world. 
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[ CONQUER THE COMMAND LINE ] qd g ita | a D D 
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CHAPTER sh 
CUSTOMISE tHe eee 


COMIN INNIBE BINS ae 


The command look at that blinking cursor on your terminal, and what’s 
presents your cut-out-and-keep pedestal behind it: pi@raspberrypi ~ $ ae | J a4 
guide to using the command line on the Raspberry Pi. papieedir ae [The 9 Keun as the lle BOE amt tees 
SE Rag SRISn GTi i fdenttywnhor, command; before ity tilde), shorthand for ‘home? - which 
In part 5, we make Raspbian alittle more personal as withouta change is /home/pi in this case. Before that is [user name]@[computer name], 
we get it to behave and look just the way you want it... seeentiroucen in the form pi@raspberrypi. Not only ormative (at least if ! 


‘whatyouncedto you've forgotten who and 
doinanother role nas 
change and personali 


w | LINE 


DE 


New user 

Let’s start with that user name ~ pi. If more than one person in 

your family uses the Pi, you may want to keep the pi user for shared 
projects, but set up individual login accounts for fami 

including yourself. Creating a new user in Raspbian is ea 

adduser jo ...will treate a new user account named jo. 

prompted for a password (pick a good one) and lots of irrelevant info 
(dating back to shated university computers ofthe 19705) that you can 
safely ignore b prompt. Now we have a 
user account for jo, ha ook ooks empty? Use ls -A. 
Jo has never logged|into the computer, so you will see the absence of 
most of the contents of /home/pi for now, such as ~/.gconf, but there 
isa-bashre and a couple of other config files 
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Serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout Pi Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential P| 


8 channel 18 bit analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. |?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RTC Pi Plus 


Real-time clock with battery backup 
and 5V |I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I?C address 
selection. 


SlGCTrOnICs 


Now 
Available 
for the 
Pi Zero 


SAVE 


15% 


“MagPi15” 


discount code 


GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 


Connect hundreds of sensors 
to your Raspberry Pi! 


